Skill Show Catalogue

When the user asks what skills exist, wants the skill list grouped sensibly ("list skills", "what can you do", "show the catalogue"), or needs to find the right skill for an action. The raw Claude Code skill selector is a flat alphabetical list; this is the readable, domain-grouped view.

1. Open with a one-paragraph preamble on methodology: every skill is named <domain>-<verb>[-<object>] after the action it performs, per Skill naming conventions — so to find a skill, think "what do I want to do", pick the domain prefix, then scan its verbs. Compass does the heavy lifting of finding skills:

   ./projects/ores.compass/compass.sh list --type skill
   ./projects/ores.compass/compass.sh search "<action>"
   

2. Check the catalogue is fresh — it is generated from the SKILL.org sources:

   python3 build/scripts/generate_skills_catalogue.py --check
   

   If stale, run without --check first (and flag the drift to the user — generated docs should not go stale on main).

3. Check the deployed bundle is fresh — compass bearings already performs this check (oldest deployed file vs newest source, so a partially-stale deployment warns); heed its warning, or compare directly:

   [ "$(find doc/llm/skills -type f -newer .claude/skills -print -quit 2>/dev/null)" ] \
     && echo "stale - run: compass build --direct skills" || echo "fresh"
   

   If stale, redeploy with compass build --direct skills and remind the user to /reload-skills.

4. Read the generated region of the Skills catalogue (doc/llm/skills/claude_code_skills.org).
5. Present one section per domain prefix, in register order (agile-, pr-, doc-, code-, codegen-, devops-, skill-): a heading, the one-line domain blurb, then a table of name / description (drop the Title column — name and description carry the meaning). Include the planned-but-not-yet-created skills as a short note under each section, and skip the Retired section unless asked.
6. If the user is hunting for an action, finish with the closest matching skill name and a one-line "invoke it with /<name>" hint — found via compass search, not by eyeballing the list.

• How do I deploy the skills? — if the bundle looks out of date.

• Skills catalogue — the generated inventory this skill renders.
• Skill naming conventions — the registers that define the grouping.