Skill

/skill — Create Cursor Skills

Create Agent Skills for .cursor/skills/ following the agentskills.io specification. Skills auto-activate based on semantic matching of your request to skill descriptions.

Skill Types

Directory Standard

skill-name/
├── SKILL.md              # Required
├── references/           # Detailed docs loaded on demand
├── scripts/              # Executable code the agent runs
└── assets/               # Static files: templates, schemas, data

When to create each folder:

Workflow

Phase 1: Parse Request

**Skill Request Analysis**
**Name:** [kebab-case]
**Type:** [technique / reference / guardrail]
**Purpose:** [What problem does it solve?]
**Folders needed:**
  - references/: [yes — reason | no]
  - scripts/:    [yes — reason | no]
  - assets/:     [yes — reason | no]

Phase 2: Check for Existing Skills

ls -la .cursor/skills/
find .cursor/skills -name "SKILL.md" -exec head -3 {} \; -print

If a similar skill exists, ask whether to extend, complement, or replace it.

Phase 3: Delegate to @skill-author

Use the @skill-author agent to create this skill:

**Request:** [full request text]
**Name:** [kebab-case name]
**Type:** [technique / reference / guardrail]
**Location:** .cursor/skills/[name]/

**Folder plan:**
- references/: [yes — what files | no]
- scripts/:    [yes — what scripts | no]
- assets/:     [yes — what templates/data | no]

Starter templates: .cursor/skills/skill/assets/
Validation script: .cursor/skills/skill/scripts/validate-skill.sh

TDD process:
1. Baseline test WITHOUT skill — record failures verbatim
2. Write SKILL.md + populate folders addressing those failures
3. Test WITH skill — verify fix
4. Close loopholes, re-test
5. Run validate-skill.sh

Return a <skill-author-result> block.

Wait for <skill-author-result> block before proceeding.

Phase 4: Validate

bash .cursor/skills/skill/scripts/validate-skill.sh .cursor/skills/[skill-name]/
ls -la .cursor/skills/[skill-name]/
wc -l .cursor/skills/[skill-name]/SKILL.md

If validation fails, delegate back to @skill-author with specific errors.

Phase 5: Report

## Skill Created ✅

**Location:** `.cursor/skills/[name]/`
**Type:** [technique / reference / guardrail]
**Lines:** [SKILL.md line count]

**Structure:**
- `SKILL.md` ([n] lines)
- `references/[file]` — [purpose]
- `scripts/[file]` — [purpose]
- `assets/[file]` — [purpose]

**Baseline failures addressed:**
1. [failure] → [fix]

**Next steps:**
- [ ] Test with a real scenario to verify activation
- [ ] `git add .cursor/skills/[name]/`

Spec Resources