Task: Audit existing skills: rename or delete per convention
This page documents a task in the Action-oriented skill cleanup story. It captures the goal, current status, acceptance, and any notes or results.
1. Goal
Bring all existing skills into line with Skill naming conventions: rename conformable skills to action-oriented names, dissolve role skills, demote reference-only skills to the knowledge docs they front, delete superseded skills, and update every living cross-reference. Historical sprint documents are archives and are not rewritten.
2. Status
| Field | Value |
|---|---|
| State | DONE |
| Parent story | Action-oriented skill cleanup |
| Now | Nothing. |
| Waiting on | Nothing. |
| Next | Nothing. |
| Last touched | 2026-06-06 |
3. Acceptance
- Every surviving skill name parses against the prefix and verb registers.
- Deleted and demoted skills are recorded in the catalogue's Retired section.
- No living document (runbooks, recipes, knowledge, functions, current sprint) references a retired name.
- Deployed
.claude/skills/matches thedoc/llm/skills/sources exactly.
4. Plan
(Transient implementation strategy. Written when work starts;
distilled into the parent story's * Decisions and cleared when the
task closes. Plans do not outlive their task.)
5. Notes
Disposition of all 41 pre-existing skills (28 renames, 9 retired, 1 audit-time rename, 3 kept as-is):
| Old | Fate |
|---|---|
| sprint-planner | compass-agile-plan-sprint |
| sprint-reviewer | compass-agile-review-sprint |
| new-sprint | compass-agile-open-sprint |
| backlog-refiner | compass-agile-refine-backlog |
| capture | agile-add-capture |
| brainstorming | compass-agile-brainstorm-idea |
| relese-notes-generator | compass-agile-add-release-notes (typo fixed) |
| init-session | compass-agile-find-bearings (already implemented the action) |
| recipe-author | compass-doc-add-recipe |
| manual-updater | compass-doc-update-manual |
| ores-memory | compass-doc-add-memory |
| ores-recipe-sync | compass-doc-sync-recipes |
| plantuml-class-modeler | compass-doc-add-class-diagram |
| plantuml-er-modeler | compass-doc-add-er-diagram |
| component-model-creator | compass-doc-add-component-model |
| tufte-viz | compass-doc-add-chart |
| cmake-runner | compass-code-run-build |
| unit-test-writer | compass-code-add-tests |
| test-failure-investigator | compass-code-investigate-test-failure |
| domain-type-creator | compass-code-add-domain-type |
| entity-creator | compass-codegen-add-entity |
| qt/cli/http/shell/wt-entity-creator | codegen-add-{qt,cli,http,shell,wt}-entity |
| component-creator | compass-codegen-add-component |
| sql-schema-creator | compass-codegen-add-sql-schema |
| skill-manager | compass-skill-add |
| compass-code-review-pr, compass-code-review-component, compass-skill-review | kept (already conformant) |
| run-runbook | deleted — one skill per runbook |
| pr-manager, pr-shepherd | deleted — dissolved into the pr- set |
| feature-branch-manager | deleted — lifecycle skills + compass-code-start-branch |
| agile-product-owner, system-architect, semi-autonomous-developer | deleted — roles dissolved into actions |
| design-principles, icon-guidelines | deleted — demoted to their knowledge docs |
Verb register extended during the audit (decision-logged): review,
update, open, investigate, brainstorm; write rejected in
favour of add.
The catalogue is now a generated artefact:
build/scripts/generate_skills_catalogue.py rewrites the
marker-delimited region from the SKILL.org sources and has a
--check mode for CI. Folding this (and the other catalogue
regenerators) into compass is raised as a task on the Consolidate
standalone scripts into compass story.
6. PRs
| PR | Title |
|---|---|
7. Review
| Comment summary | File | Decision | Notes |
|---|---|---|---|
8. Result
All 41 pre-existing skills audited and dispositioned: 29 renamed to register-conformant action names (including init-session → compass-agile-find-bearings), 9 retired (4 dissolved roles/managers, 2 demoted to knowledge, run-runbook + pr-manager + pr-shepherd superseded), 3 already conformant. Verb register extended with review/update/open/investigate/brainstorm. Living docs (functions, recipes, knowledge, runbooks, sprint 20) re-pointed; historical sprints left as archives. Catalogue regenerated as a derived artefact via build/scripts/generate_skills_catalogue.py; deployed bundle rebuilt and stale directories purged — .claude/skills now mirrors doc/llm/skills exactly.