skills-guide

To find the right skill command, you can use a discovery catalog that cross-analyzes skill metadata and current signals like git status to recommend the most relevant 3–5 options for your specific context.

Context-aware skill recommendation maps free-text user intent to actionable commands by extracting signals from conversation keywords, recent outputs, and git status, filtering through metadata to select top matches.

You can browse available skill groups for specific tasks like diagnosis or code review by navigating grouped categories such as core, diagnosis, write, review, plan, and data to find relevant commands.

Skill discovery does require loading metadata from specific files, reading SKILL.md files within skill directories, and optionally using CONTRACT.md to validate contracts during the onboarding flow.

You can use keyword search to filter a skill catalog for your current project setup by providing a sentence describing your intent, which triggers tools like Glob and Grep to extract matching signals.

The best way to set up and validate skill contracts for a new project is using a guided first-time onboarding flow that loads metadata and checks CONTRACT.md files to ensure correct command mapping.