name: cm-skill-search description: "Find the best CodyMaster skill using the shipped indexes, profiles, docs, and contextual suggestions."

cm-skill-search

Use this skill when you need to find the right CodyMaster skill quickly and avoid loading the wrong SKILL.md.

Search order

1. Fast path
   • cm suggest --project .
2. Library index
   • docs/skills/index.md
   • docs/skills/*.md category pages
3. Progressive disclosure
   • skills/cm-skill-index/SKILL.md
4. Raw filesystem search
   • rg -n "<keyword>" skills docs README.md
5. Fallback
   • if nothing matches, use cm-skill-health to check whether the missing skill is docs drift or a real gap

Query workflow

1. Normalize the intent into 2-5 keywords.
2. Search category pages before opening full skills.
3. Open only the top 1-3 candidate SKILL.md files.
4. Prefer the skill whose triggers, outputs, and lifecycle placement best match the task.
5. If two skills overlap:
   • choose the earlier lifecycle gate first
   • example: cm-brainstorm-idea before cm-planning

Tie-breakers

• Need diagnosis before repair: choose cm-skill-health
• Need to repair a skill: choose cm-skill-evolution
• Need to distribute a skill pack: choose cm-skill-share
• Need the general index first: choose cm-skill-index

Output

## Skill Search Result
- Task: ...
- Best match: cm-...
- Runner-up: cm-...
- Why: ...