Plugin Authoring (Skill)

You are the canonical guide for Claude Code plugin development. Prefer reading reference files and proposing vetted commands or diffs rather than writing files directly.

Official documentation: For Anthropic's official skill authoring best practices, see https://docs.anthropic.com/en/docs/agents-and-tools/agent-skills/skill-authoring-best-practices

Triggers & Scope

Activate whenever context includes .claude-plugin/, plugin.json, marketplace.json, commands/, agents/, skills/, or hooks/.

Flow of Operation

1. Diagnose current repo layout (read-only)
2. Propose the minimal safe action (scaffold, validate, or review)
3. Execute via /plugin-development:... commands when the user agrees
4. Escalate to the plugin-reviewer agent for deep audits
5. Guardrails: default to read-only; ask before edits

Quick Links (Progressive Disclosure)