Skill Structure

Folder structure

A minimal skill looks like this:

my-skill/
├── SKILL.md        # Required: main entry point
└── skill.json      # Required: metadata

A complete skill with references:

my-skill/
├── SKILL.md
├── skill.json
└── references/
    ├── context.md
    ├── examples.md
    └── style-guide.md

skill.json

{
  "id": "my-skill",
  "name": "My Skill Name",
  "version": "1.0.0",
  "author": "your-username",
  "category": "writing",
  "tags": ["tag1", "tag2"],
  "free": true,
  "compatibility": ["claude-3.5", "gpt-4o"]
}

SKILL.md sections