create-skill

name	create-skill
description	Use this skill when the user asks to create a new agent skill. Creates the skill directory under ~/.agents/skills/ and links it into all detected agents so they can pick it up.

Create Skill

When the user asks to create a new skill, follow this convention.

Directory structure

Skills live in ~/.agents/skills/<name>/ and are linked into each agent's skills directory:

~/.agents/skills/
  <name>/
    SKILL.md        ← source of truth, edit this
~/.claude/skills/
  <name>            ← symlink → ~/.agents/skills/<name>  (Claude Code)
# ...and equivalent paths for other detected agents

Steps

1. Create the skill

Check whether npx skills is available:

npx skills --version 2>/dev/null

If available, use it to scaffold the skill:

npx skills init <name> --dir ~/.agents/skills

This creates ~/.agents/skills/<name>/SKILL.md with a starter template. Edit that file to fill in the real content.

If not available, create manually:

mkdir -p ~/.agents/skills/<name>

Then write ~/.agents/skills/<name>/SKILL.md using this template:

---
name: <name>
description: Use this skill when <trigger condition>. 
---









 First step
 Second step