Decision 0004 · Accepted
Portable skill catalog
and distribution
The repository previously shipped twenty-five skills, a flow workflow router, and an optional flow-skills-init bootstrap that merged AGENTS.md markers.
- Status
- Accepted
- Built from:
- da88c48
Status: accepted (2026-10-27). Amended by 0062 (distribution adds a Claude Code plugin with hooks; npx skills add remains for skills).
Context
The repository previously shipped twenty-five skills, a flow workflow router, and an optional flow-skills-init bootstrap that merged AGENTS.md markers. Product direction called for agent-agnostic, manually invoked skills without mandatory setup or adopter instruction changes.
Decision
- Ship twelve skills:
explore,grill,to-spec,to-tickets,implement,review,retro,interview,jtbd,competitors,write-agents,write-humans. - Retire the
flowrouter, quality-only skills, delivery helpers (ship,doctor, …), and the npm init/bootstrap installer from the distribution. - Primary installation:
npx skills add gaboesquivel/flow-skillsvia the Agent Skills ecosystem. Do not hardcode a default agent flag. - Default spec path for projects without a convention:
docs/specs/NNN-short-name.md. - Rename writing skills from
write-for-agents/write-for-humanstowrite-agents/write-humans.
Consequences
- Validator and tests target the fixed twelve-skill list, not a growing count invariant.
- Historical decision 0003's twenty-five-skill catalog and bootstrap install path are superseded for current distribution.
- Decision 0002's offline tarball copy remains possible for maintainers but is not the primary user install story.
Supersedes
Partially supersedes 0003 catalog shape and install guidance. Local ownership principles in 0002 still apply to editing skills/ in this repository.
Superseded in part by
0006 reintroduces the flow skill id as Flow Lite (context alignment only), not as the workflow router retired above.
0013 restores council, ship, prototype, simplify, security, performance, and debug as explicit skills. The router and the other retired names stay retired.