Skip to content

Using Skills ​

What a skill is ​

Each skill is a folder under skills/<skill-id>/ containing **SKILL.md** β€” instructions the agent follows (workflows, checklists, output formats). Skills are validated by:

bash
npm run validate:skills
npm run check:skills

(package.json β†’ scripts/validate-skills.mjs, scripts/build-skills.mjs)

How to use them in practice ​

  1. Name the skill in your prompt β€” e.g. β€œFollow cm-tdd before writing implementation code.”
  2. Load the file if your client supports file attachments β€” open skills/cm-planning/SKILL.md.
  3. Chain work β€” when a skill says β€œhand off to X”, switch to that skill explicitly.
  4. Persist outputs β€” write summaries to .cm/ or memory as the skill describes so MCP tools can find them later.

Discovery ​

  • Browse the categorized lists in the Skills library.
  • Use your editor search across skills/**/SKILL.md for keywords.

CLI vs skills ​

MechanismWhat it does
cm … commandsRuns TypeScript in this repo
SkillsTells the agent how to use tools and what to produce

See also ​

CodyMaster β€” AI-assisted engineering toolkit