Getting Started

Your first skill in 5 minutes

On this page

1. Scaffold a new skill

Run chain new my-skill to create the folder and template file.

chain new my-skill

2. Open the file

Open ~/chain-hub/skills/my-skill/SKILL.md in your editor. The template already includes a name and placeholder description.

3. Write your instructions

Edit the description field (when to use this skill) and the body (what to do). Keep it focused and under 200 lines.

4. Validate

Check frontmatter and structure before you rely on the skill in an editor.

chain validate

5. Use it in your editor

Mention the skill by name or describe the scenario it covers. The AI picks it up from the linked directory.

No restart needed — skills are loaded fresh each session. If a skill doesn’t appear, run chain setup and reopen your editor.