CE Skill Registry Sync
Use this skill whenever .claude/skills/ changes or whenever a user requests
any skill listing update.
RTD taxonomy model (authoritative)
When maintaining grouped sections in docs/contributor/agent_skills.md, apply
this deterministic classification model:
- Primary deliverable rule (highest priority):
- prediction or explanation outputs -> Practitioner Workflows
- production implementation changes -> Contributor Implementation and Extensibility
- quality findings, tests, or remediation plans -> Quality, Testing, and Risk Control
- ADR, docs, registry, or process artifacts -> Governance, Documentation, and Skill Operations
- Primary user rule (tie-breaker):
- end user or analyst -> Practitioner Workflows
- code contributor -> Contributor Implementation and Extensibility
- reviewer or QA maintainer -> Quality, Testing, and Risk Control
- maintainer or documentation owner -> Governance, Documentation, and Skill Operations
- Single-primary placement rule:
- each skill must appear exactly once in one primary RTD subcategory
- Subcategory rule:
- choose subcategory by dominant workflow type (build/configure, audit/review, author/coordinate)
RTD maintenance checks
When adding or reclassifying skills in docs/contributor/agent_skills.md:
- Keep single-primary placement (one subcategory per skill in RTD).
- Ensure all
.claude/skills/* entries are listed exactly once.
- Keep links stable (
.claude/skills/<skill>/SKILL.md).
- Apply the taxonomy model above before introducing new subcategories.
Mandatory policy
If any skill directory or SKILL.md file is added, removed, renamed, or moved:
- Update
CONTRIBUTOR_INSTRUCTIONS.md Table 6A in the same patch.
- Update
.claude/skills/ce-onboard/SKILL.md section 4 skill catalogue in the same patch.
- Update
docs/contributor/agent_skills.md in the same patch.
- Ensure the skill name, path, and primary-use text are accurate in Table 6A.
- Ensure intent-to-skill mapping is accurate in ce-onboard section 4.
- Ensure each RTD skill row contains a valid skill link.
- Keep registry lists sorted alphabetically by skill name where applicable.
- Do not leave stale rows for removed or renamed skills.
- Apply the RTD taxonomy model above when updating grouped RTD sections.
- Do not complete the task unless all registries and filesystem state match.
Always perform full-set reconciliation:
- Enumerate all directories under
.claude/skills/.
- Ensure each directory has exactly one corresponding entry in:
CONTRIBUTOR_INSTRUCTIONS.md section 6A table, and
.claude/skills/ce-onboard/SKILL.md section 4 catalogue, and
docs/contributor/agent_skills.md table.
- Ensure neither registry contains entries for non-existent skills.
Verification steps (required)
Run all checks:
rg --files .claude/skills
rg -n "## 6A|ce-skill-registry-sync|Maintenance rule" CONTRIBUTOR_INSTRUCTIONS.md
rg -n "## 4\\. Skill catalogue|ce-skill-registry-sync" .claude/skills/ce-onboard/SKILL.md
rg -n "Agent skill catalogue|ce-skill-registry-sync|\\.claude/skills/.*/SKILL.md" docs/contributor/agent_skills.md
Then compare the discovered skill folders to:
CONTRIBUTOR_INSTRUCTIONS.md Table 6A entries
.claude/skills/ce-onboard/SKILL.md section 4 catalogue entries
docs/contributor/agent_skills.md table entries
- Confirm set equality (filesystem set == registry set for all three files).
Failure behavior
If any registry is not updated correctly, fail the task and report:
- which skill entries are missing
- which entries are stale
- the exact row(s) that must be changed in each file
1---2name: ce-skill-registry-sync3description: Synchronize all skill registries with filesystem inventory after any skill add, remove, rename, or move.4---5
6# CE Skill Registry Sync
7
8Use this skill whenever `.claude/skills/` changes or whenever a user requests
9any skill listing update.
10
11## RTD taxonomy model (authoritative)
12
13When maintaining grouped sections in `docs/contributor/agent_skills.md`, apply
14this deterministic classification model:
15
161. Primary deliverable rule (highest priority):
17- prediction or explanation outputs -> Practitioner Workflows
18- production implementation changes -> Contributor Implementation and Extensibility
19- quality findings, tests, or remediation plans -> Quality, Testing, and Risk Control
20- ADR, docs, registry, or process artifacts -> Governance, Documentation, and Skill Operations
212. Primary user rule (tie-breaker):
22- end user or analyst -> Practitioner Workflows
23- code contributor -> Contributor Implementation and Extensibility
24- reviewer or QA maintainer -> Quality, Testing, and Risk Control
25- maintainer or documentation owner -> Governance, Documentation, and Skill Operations
263. Single-primary placement rule:
27- each skill must appear exactly once in one primary RTD subcategory
284. Subcategory rule:
29- choose subcategory by dominant workflow type (build/configure, audit/review, author/coordinate)
30
31## RTD maintenance checks
32
33When adding or reclassifying skills in `docs/contributor/agent_skills.md`:
34
351. Keep single-primary placement (one subcategory per skill in RTD).
362. Ensure all `.claude/skills/*` entries are listed exactly once.
373. Keep links stable (`.claude/skills/<skill>/SKILL.md`).
384. Apply the taxonomy model above before introducing new subcategories.
39
40## Mandatory policy
41
42If any skill directory or `SKILL.md` file is added, removed, renamed, or moved:
43
441. Update `CONTRIBUTOR_INSTRUCTIONS.md` Table 6A in the same patch.
452. Update `.claude/skills/ce-onboard/SKILL.md` section 4 skill catalogue in the same patch.
463. Update `docs/contributor/agent_skills.md` in the same patch.
474. Ensure the skill name, path, and primary-use text are accurate in Table 6A.
485. Ensure intent-to-skill mapping is accurate in ce-onboard section 4.
496. Ensure each RTD skill row contains a valid skill link.
507. Keep registry lists sorted alphabetically by skill name where applicable.
518. Do not leave stale rows for removed or renamed skills.
529. Apply the RTD taxonomy model above when updating grouped RTD sections.
5310. Do not complete the task unless all registries and filesystem state match.
54
55Always perform **full-set reconciliation**:
56- Enumerate all directories under `.claude/skills/`.
57- Ensure each directory has exactly one corresponding entry in:
58 - `CONTRIBUTOR_INSTRUCTIONS.md` section 6A table, and
59 - `.claude/skills/ce-onboard/SKILL.md` section 4 catalogue, and
60 - `docs/contributor/agent_skills.md` table.
61- Ensure neither registry contains entries for non-existent skills.
62
63## Verification steps (required)
64
65Run all checks:
66
67```bash
68rg --files .claude/skills
69rg -n "## 6A|ce-skill-registry-sync|Maintenance rule" CONTRIBUTOR_INSTRUCTIONS.md
70rg -n "## 4\\. Skill catalogue|ce-skill-registry-sync" .claude/skills/ce-onboard/SKILL.md
71rg -n "Agent skill catalogue|ce-skill-registry-sync|\\.claude/skills/.*/SKILL.md" docs/contributor/agent_skills.md
72```
73
74Then compare the discovered skill folders to:
75- `CONTRIBUTOR_INSTRUCTIONS.md` Table 6A entries
76- `.claude/skills/ce-onboard/SKILL.md` section 4 catalogue entries
77- `docs/contributor/agent_skills.md` table entries
78- Confirm set equality (filesystem set == registry set for all three files).
79
80## Failure behavior
81
82If any registry is not updated correctly, fail the task and report:
83- which skill entries are missing
84- which entries are stale
85- the exact row(s) that must be changed in each file