← Explore all skills

AGENT DEVELOPMENT / Anthropic

Skill Development for Claude Code Plugins

Guides writing a skill that ships inside a Claude Code plugin: directory layout, a third-person trigger description, an imperative SKILL.md body and progressive disclosure into references/, examples/ and scripts/.

“This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.”

01 / THE REASONING

Why this made the selection.

  • It adapts the skill-creator method to plugin skills, which is what separates it from the general skill-creator: plugin skills are created by hand under plugin-name/skills/<skill-name>/ instead of with init_skill.py, ship with the plugin rather than as separate ZIP files, and are reviewed with plugin-dev's skill-reviewer agent.
  • It sets checkable writing rules: a third-person description that quotes the phrases users would say, an imperative body of about 1,500-2,000 words, detail moved to references/, and a checklist that every referenced file exists.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • plugins/plugin-dev/skills/skill-development/SKILL.md
  • plugins/plugin-dev/skills/skill-development/references/skill-creator-original.md (frontmatter and script references)
  • plugins/plugin-dev/README.md
  • plugins/plugin-dev/LICENSE
  • .claude-plugin/marketplace.json (name and plugin-dev entry)

Our findings

  • The skill directory holds SKILL.md and one reference file; it ships no script and its frontmatter declares no allowed-tools.
  • Step 3 creates the skill with mkdir -p plugin-name/skills/skill-name/{references,examples,scripts} and touch plugin-name/skills/skill-name/SKILL.md.
  • Progressive disclosure is described as three levels: name and description always in context, the SKILL.md body when the skill triggers, bundled resources as needed.
  • Plugin skills are tested by loading the plugin locally with cc --plugin-dir /path/to/plugin and asking questions that should trigger the skill.

Not established by this review

  • No skill was created or reviewed with the skill-reviewer agent.
  • references/skill-creator-original.md was read only for its frontmatter and its script references, not in full.
  • Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗
  1. The plugin-dev README's install line is `/plugin install plugin-dev@claude-code-marketplace`. claude-code-marketplace is not this repository's marketplace, which .claude-plugin/marketplace.json names claude-plugins-official, and the line installs the entire plugin, including the skill-reviewer agent this skill relies on, so it is not a command for skill-development alone and install.command is null.
  2. The SKILL.md and the README both show `cc --plugin-dir` for loading a plugin from a local directory; the README prints it as `cc --plugin-dir /path/to/plugin-dev`.
  3. Neither line was run here.

Before you start

  • Claude Code, with a plugin to add the skill to

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/skill-development/SKILL.md

    Supports: upstreamDescription, summary, whySelected[0], whySelected[1], bestFor[0], bestFor[1], bestFor[2], limitations[1], limitations[3], compatibility, review.findings[0], review.findings[1], review.findings[2], review.findings[3], access.permissions[0], access.permissions[1], install.steps[1], install.prerequisites[0]

  2. https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/skill-development/references/skill-creator-original.md

    Supports: limitations[1], limitations[2]

  3. plugin-dev README ↗Checked

    https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/README.md

    Supports: install.sourceUrl, install.steps[0], install.steps[1], limitations[3], limitations[4], limitations[5], compatibility

  4. plugin-dev LICENSE ↗Checked

    https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/LICENSE

    Supports: license, limitations[2], limitations[4], access.cost

  5. https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/.claude-plugin/marketplace.json

    Supports: limitations[5], install.steps[0]

Evidence & Ask