Skill Anatomy

Every skill is defined by a skill.json file at the root of your project. Here's the full schema:

{
  "name": "my-skill",
  "version": "1.0.0",
  "description": "What this skill does",
  "category": "Frontend",
  "author": "your-username",
  "license": "MIT",
  "instructions": "Detailed instructions for the AI agent...",
  "examples": [
    {
      "input": "Build a React button component",
      "output": "Here is a Button component..."
    }
  ],
  "tools": ["cursor", "claude"],
  "tags": ["react", "component", "ui"]
}

Required Fields

• name — Unique skill identifier (kebab-case)
• version — Semantic version (major.minor.patch)
• description — One-line description
• category — One of the supported categories
• instructions — The core skill instructions

Optional Fields

• examples — Few-shot examples (strongly recommended)
• tools — Compatible AI tools
• tags — Searchable tags
• dependencies — Other skills this skill requires