{
  "id": "skill-creator",
  "handle": "skill-creator",
  "canonicalUrl": "https://bestskillsforclaude.com/en/skills/skill-creator",
  "language": "en",
  "alternates": {
    "en": "https://bestskillsforclaude.com/en/skills/skill-creator",
    "es": "https://bestskillsforclaude.com/es/skills/skill-creator",
    "pt-BR": "https://bestskillsforclaude.com/pt-br/skills/skill-creator",
    "ja": "https://bestskillsforclaude.com/ja/skills/skill-creator"
  },
  "category": {
    "id": "extend-claude",
    "name": "Extend Claude"
  },
  "publisher": {
    "name": "Anthropic",
    "url": "https://github.com/anthropics"
  },
  "source": "https://github.com/anthropics/skills/tree/main/skills/skill-creator",
  "documentation": null,
  "licenseAsStated": "Apache 2.0",
  "runtime": "Claude apps and Claude Code",
  "lastReviewed": "2026-08-05",
  "headline": "How do you write a skill that the agent actually loads?",
  "summary": "The hard part is not the instructions. It is the description that decides when they load.",
  "verdict": "The skill-creator skill helps you create, structure and refine your own skills, including the description text that determines when a skill is triggered at all. Install it before writing your first skill, because a well written skill with a vague description will simply never be used.",
  "bestFor": "Teams turning repeated workflows into reusable skills, and anyone maintaining more than two skills.",
  "skipIf": "You have not yet repeated a workflow enough times to know what it really is.",
  "keyTakeaways": [
    "The description is the trigger. It matters more than the body.",
    "Skills should encode procedure, not general knowledge the model already has.",
    "Write from a workflow you have actually repeated, or you will encode an imagined process.",
    "Fewer, sharper skills beat a large library nobody can predict."
  ],
  "quickStart": [
    "Install it from anthropics/skills under Apache 2.0.",
    "Start from a workflow you have already done three times by hand.",
    "Test the trigger by describing the task in the words a colleague would use, not the words you used when writing it."
  ],
  "sections": [
    {
      "heading": "What it changes in practice",
      "paragraphs": [
        "A skill is only useful if it loads at the right moment. Most first attempts fail there: the instructions are fine, but the description is written in the author's vocabulary, so it never matches how anyone else describes the task.",
        "Working with a skill that knows the format also stops the common mistake of writing an essay. A skill is a procedure with decision points, not documentation of a topic."
      ]
    },
    {
      "heading": "Where it disappoints",
      "paragraphs": [
        "It cannot tell you whether the workflow is worth encoding. That judgement comes from having done the work repeatedly and noticed the same steps.",
        "Large skill libraries also become their own problem: overlapping descriptions make triggering unpredictable, and the fix is deletion rather than more skills."
      ]
    }
  ],
  "faq": [
    {
      "question": "What makes a skill trigger reliably?",
      "answer": "A description written in the words a user would use for the task, covering the phrasings you expect in practice."
    },
    {
      "question": "What should not go in a skill?",
      "answer": "General knowledge the model already has. Skills are for procedure, conventions and house specifics."
    },
    {
      "question": "How many skills is too many?",
      "answer": "When descriptions start overlapping, triggering becomes unpredictable. That is the signal to merge or delete."
    }
  ],
  "sources": [
    {
      "label": "anthropics/skills on GitHub",
      "url": "https://github.com/anthropics/skills",
      "kind": "repository"
    },
    {
      "label": "anthropics/skills, skill-creator skill directory",
      "url": "https://github.com/anthropics/skills/tree/main/skills/skill-creator",
      "kind": "documentation"
    }
  ],
  "machineReadable": {
    "markdown": "https://bestskillsforclaude.com/en/skills/skill-creator/content.md",
    "json": "https://bestskillsforclaude.com/en/skills/skill-creator/skill.json"
  },
  "disclosure": "Editorial desk review based on the publisher's own repository. Not a security audit, a benchmark or a guarantee of maintenance."
}