Agent skill

Software Lifecycle

by inkeep in inkeep/open-knowledge

How to work in a Software Lifecycle project (the software-lifecycle starter pack): proposals → decisions → specs → postmortems, plus guides.

GPL-3.0Auto-check passedDevOps & Cloud

Install Software Lifecycle

skills CLI
$ npx skills add inkeep/open-knowledge --skill software-lifecycle -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install inkeep/open-knowledge software-lifecycle --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/inkeep/open-knowledge.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/server/assets/skills/packs/software-lifecycle .claude/skills/software-lifecycle && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
software-lifecycle
GitHub stars
4.4k
Token cost
~1.2k tokens
SKILL.md length
452 words
Files
2
Skills in repo
18
Repo updated
First seen
Licence
GPL-3.0

At a glance

How to work in a Software Lifecycle project (the software-lifecycle starter pack): proposals → decisions → specs → postmortems, plus guides.

  • Tasks that involve Runbooks and postmortems
  • SKILL.md covers The flow, Per-folder rules + agent…, The five workflows and Templates
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Proposals and quotes

What it does

Software Lifecycle is an agent skill from inkeep/open-knowledge. How to work in a Software Lifecycle project (the software-lifecycle starter pack): proposals → decisions → specs → postmortems, plus guides. Read when the project has these folders, or when asked how this project is organized. Carries the doc lifecycle, status flows, and per-folder agent behaviors so that guidance does not live inside template bodies or folder descriptions. The five workflows — frame a proposal, write a spec, record a decision, write a postmortem, review a design — each ship as their own sibling…

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `plugin.json`). Compatibility notes: Any agent host with the OpenKnowledge MCP server configured. Installed project-local by ok seed --pack software-lifecycle.

It sits in DevOps & Cloud, covering Runbooks and postmortems and Proposals and quotes. The repository describes itself as: Beautiful, AI-native markdown IDE and LLM wiki. The licence is GPL-3.0.

When your agent uses it

  • Tasks that involve Runbooks and postmortems
  • Tasks that involve Proposals and quotes

Example prompts

  • “/software-lifecycle”

Requirements

  • Compatibility (from SKILL.md): Any agent host with the OpenKnowledge MCP server configured. Installed project-local by `ok seed --pack software-lifecycle`.

What it can do on your machine

Read from SKILL.md and the folder at commit cf9b84c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Any agent host with the OpenKnowledge MCP server configured. Installed project-local by `ok seed --pack software-lifecycle`.

    From compatibility in the SKILL.md frontmatter.

Context cost

Software Lifecycle loads about 1.2k tokens when it runs. Until then it costs about 157 tokens; SKILL.md has 452 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~157
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from inkeep/open-knowledge at commit cf9b84c, republished under its GPL-3.0 licence (© inkeep). 452 words, ~1,183 tokens.

Download SKILL.mdSave it as .claude/skills/software-lifecycle/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
software-lifecycle
description
How to work in a Software Lifecycle project (the `software-lifecycle` starter pack): proposals → decisions → specs → postmortems, plus guides. Read when the project has these folders, or when asked how this project is organized. Carries the doc lifecycle, status flows, and per-folder agent behaviors so that guidance does not live inside template bodies or folder descriptions. The five workflows — frame a proposal, write a spec, record a decision, write a postmortem, review a design — each ship as their own sibling skill in this pack. Complements the platform `open-knowledge` skill; does not replace it.
compatibility
Any agent host with the OpenKnowledge MCP server configured. Installed project-local by `ok seed --pack software-lifecycle`.
metadata.pack
software-lifecycle
metadata.author
Inkeep
metadata.repository
https://github.com/inkeep/open-knowledge-skills

Software Lifecycle pack — how to work here

This project holds the doc lifecycle for an engineering team or OSS project. The flow is proposals → decisions → specs → postmortems, with guides as the how-to bucket. This skill holds the workflow so templates and folder descriptions stay clean.

This skill is pack guidance. The platform /open-knowledge skill (read/write/preview/linking/grounding rules) still governs every markdown operation — this layers the lifecycle conventions on top.

The flow

proposals/    in-flight RFC-shape design proposals
   ↓ accepted
decisions/    frozen ADRs (the record of what was decided)
   ↓ derived
specs/        implementation specs for accepted proposals
   ↓ when things break
postmortems/  blameless incident write-ups
guides/       how-to / onboarding / runbooks (referenced throughout)

Per-folder rules + agent behaviors

proposals/ — One file per proposal (0001-feature-name.md). Status flows draft → fcp → accepted/rejected. An accepted proposal graduates to a record in decisions/. Shape: Motivation / Design / Drawbacks / Alternatives / Unresolved questions. Agent: when a proposal sits at status: draft more than 14 days, surface it for the author to advance, park, or close.

decisions/ — Architecture Decision Records (MADR / Nygard shape). Frozen once accepted. One file per decision (NNNN-title.md); status proposed/accepted/deprecated/superseded. A new decision that supersedes an older one links back via Supersedes:. Agent: on a new decision, scan existing records touching the same subsystem and surface Supersedes: candidates before commit.

specs/ — Implementation specs derived from accepted proposals. Prefer the github/spec-kit shape: one folder per spec (specs/NNN-name/) with spec.md + plan.md + tasks.md (the pack ships all three templates). References the parent proposal. Agent: when a spec moves to status: shipped, suggest a postmortem template if the owner reports an incident in the spec's subsystem.

postmortems/ — Blameless incident write-ups, one file per incident (YYYY-MM-DD-name.md): Summary / Timeline / Root cause / What went well / Action items (Google SRE shape). Agent: surface a Related: block linking prior postmortems that share subsystems.

guides/ — How-to guides, onboarding docs, and service-bound runbooks (Diátaxis how-to). Ships guide, onboarding-guide, and runbook templates. Carries last_verified so stale guides surface in periodic reviews. Agent: when a postmortem is published, scan its action items for guide-shaped follow-ups and stub a guide pre-filled with the symptom and timeline excerpt.

Show full SKILL.md (149 more words)Show less

The five workflows

Authoring in this project is procedural, not conventional. Each workflow ships as its own skill so it loads only when the work calls for it — reach for the one that matches the task rather than writing into a folder from scratch.

WorkflowSibling skillWhen
Frame a proposal/frame-a-proposalA change needs designing and arguing before anyone builds it.
Write a spec/write-a-specAn accepted proposal needs scoping into an implementable spec.
Record a decision/record-a-decisionA decision was actually made and needs its context and consequences preserved.
Write a postmortem/write-a-postmortemAn incident happened and the team needs a blameless write-up.
Review a design/review-a-designAn existing proposal, spec, or decision needs pressure-testing for soundness.

Templates

Create docs with write({ document: { path, template: "<name>" } }). Templates carry only structure (headings + frontmatter scaffold); what each section is for is described above, not repeated in the document body.

© inkeep, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in packages/server/assets/skills/packs/software-lifecycle of inkeep/open-knowledge.

  • SKILL.md
  • plugin.json

Open the folder on GitHubat commit cf9b84c

Compare with similar skills

Software Lifecycle next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Software Lifecycle compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Software Lifecycle this skillinkeep/open-knowledge4.4k—~1.2kAutomated safety check: PassGPL-3.0
Gh Doc Authorcaarlos0/dotfiles220—~2.2kAutomated safety check: PassMIT
Architecturenteract/nteract178—~497Automated safety check: PassBSD-3-Clause
Trader Memory Coretradermonty/claude-trading-skills3k2 repos~4.3kAutomated safety check: PassMIT
Author Migrationnrwl/nx29k—~12kAutomated safety check: NotesMIT
Write Notes Like Deepseekczm15053/write-notes-like-deepseek477—~1.9kAutomated safety check: PassNone

Similar skills

  • Gh Doc Author

    caarlos0/dotfiles

    Author and revise clear GitHub internal documentation, including design docs, proposals, decision records, runbooks, status updates, and handoffs.

    220 GitHub stars~2.2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Architecture

    nteract/nteract

    Architecture and documentation framing for cross-cutting repo decisions, docs taxonomy placement, ADRs, memos, PRDs, implementation plans, audits, measurements, runbooks, and source-grounded…

    178 GitHub stars~497 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Trader Memory Core

    tradermonty/claude-trading-skills

    Track investment theses across their lifecycle — from screening idea to closed position with postmortem.

    3k GitHub starsUsed in 2 repos~4.3k tokens
    DevOps & CloudAuto-check passed
  • Author or scope a first-party Nx migration. An agent skill from nrwl/nx.

    29k GitHub stars~12k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Write Notes Like Deepseek

    czm15053/write-notes-like-deepseek

    A skill your agent uses when a change is non-trivial by DSH standards (behavior, architecture, cross-file contracts, process/tooling, testing strategy, or on-disk/wire/config formats), when choosing…

    477 GitHub stars~1.9k tokensUpdated 15 days ago
    DevOps & CloudAuto-check passed
  • OpenRig Upgrade Procedure

    mvschwarz/openrig

    Walks an agent through upgrading the OpenRig CLI and daemon one observed step at a time, keeping live seats alive and reconciling managed plugin files.

    5.5k GitHub stars~2.9k tokensUpdated today
    DevOps & CloudAuto-check passed

More from inkeep/open-knowledge

All 18 skills in this repo
  • Open Knowledge Write Skill

    inkeep/open-knowledge

    A skill your agent uses when the user wants to create, author, write, or design a new Agent Skill (a SKILL.md) — for OpenKnowledge or for their editors — including requests like 'help me write a…

    4.4k GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Open Knowledge Discovery

    inkeep/open-knowledge

    Read when the user asks what OpenKnowledge is, wants to install it on a repository, wants to open or preview a single markdown file that is not part of an OpenKnowledge project, wants to share an…

    4.4k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Write A Postmortem

    inkeep/open-knowledge

    Write a blameless incident postmortem under postmortems/ following the Google SRE shape — evidence-based timeline, trigger vs root cause vs symptom, contributing factors, what went well, and…

    4.4k GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Codebase Wiki

    inkeep/open-knowledge

    How to work in a Codebase Wiki project (the codebase-wiki starter pack): an agent-authored, source-grounded wiki of the surrounding codebase.

    4.4k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Open Knowledge

    inkeep/open-knowledge

    Authoritative agent-runtime contract for working inside an OpenKnowledge project — a markdown-CRDT knowledge base exposed over MCP.

    4.4k GitHub stars~4.7k tokensUpdated today
    Auto-check passed
  • Consolidate Notes

    inkeep/open-knowledge

    Promote existing research into a stable-status canonical article under articles/ in a Knowledge Base project (the knowledge-base starter pack).

    4.4k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Categories

Questions about Software Lifecycle

What does Software Lifecycle do?

How to work in a Software Lifecycle project (the software-lifecycle starter pack): proposals → decisions → specs → postmortems, plus guides. Software Lifecycle is an agent skill from inkeep/open-knowledge. How to work in a Software Lifecycle project (the software-lifecycle starter pack): proposals → decisions → specs → postmortems, plus guides.

When should I use Software Lifecycle?

Software Lifecycle fits situations like: tasks that involve Runbooks and postmortems; tasks that involve Proposals and quotes.

How do I install Software Lifecycle in Claude Code?

Run `npx skills add inkeep/open-knowledge --skill software-lifecycle -a claude-code`. Or copy the skill folder (packages/server/assets/skills/packs/software-lifecycle in inkeep/open-knowledge) into .claude/skills/software-lifecycle in your project. Claude Code loads it when a task matches its description.

How do I install Software Lifecycle in Codex?

Run `npx skills add inkeep/open-knowledge --skill software-lifecycle -a codex`. Or copy the skill folder (packages/server/assets/skills/packs/software-lifecycle in inkeep/open-knowledge) into .agents/skills/software-lifecycle in your project. Codex loads it when a task matches its description.

Can I use Software Lifecycle in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add inkeep/open-knowledge --skill software-lifecycle -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/software-lifecycle, .gemini/skills/software-lifecycle, .github/skills/software-lifecycle and .opencode/skills/software-lifecycle in your project.

What does Software Lifecycle need to run?

SKILL.md names no scripts, command-line tools or credentials: Software Lifecycle is instructions for the agent only. Compatibility (from SKILL.md): Any agent host with the OpenKnowledge MCP server configured. Installed project-local by `ok seed --pack software-lifecycle`..

Does Software Lifecycle access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Software Lifecycle safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Software Lifecycle use?

Software Lifecycle is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Software Lifecycle use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Software Lifecycle?

Skills that share tags, products or a category with Software Lifecycle: Gh Doc Author (caarlos0/dotfiles, 220 stars), Architecture (nteract/nteract, 178 stars), Trader Memory Core (tradermonty/claude-trading-skills, 3k stars) and Author Migration (nrwl/nx, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Software Lifecycle?

inkeep (a GitHub organization) maintains it in inkeep/open-knowledge, which has 4,407 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 7, 2026.

Source: inkeep/open-knowledge on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.