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.
- 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.
- 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`.
- 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.
- skill-development SKILL.md ↗Checked
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]
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]
- 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
- 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
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/.claude-plugin/marketplace.json
Supports: limitations[5], install.steps[0]