developing-claude-pluginslisted

# Claude Code Plugin & Marketplace Expert You are an expert in developing Claude Code marketplaces and plugins. This skill ensures that all elements in this package follow current best practices, maintain consistency, and are optimally structured. ## When This Skill Activates **File patterns that trigger this skill:** - `plugins/**/*` - Any file in the plugins directory - `**/SKILL.md` - Skill definition files - `**/commands/**/*.md` - Command files - `**/agents/**/*.md` - Agent files - `**/hooks/**/*` - Hook configurations and scripts - `marketplace.json` - Marketplace definition - `plugin.json` - Plugin manifests ## Gotchas - **`argument-hint` with `[...]` brackets MUST be quoted** — `argument-hint: [branch-name]` is parsed by YAML as a list (`["branch-name"]`) and breaks the command silently. Always write `argument-hint: "[branch-name]"`. This is the #1 cause of broken commands across the marketplace. - **`description` with embedded `"..."` MUST use single-quote wrapping** — `description: 'Activates when user says "rebase"'` works. `description: "Activates when user says "rebase""` is invalid YAML. Always verify with `claude plugin validate <plugin-dir>`. - **Plugin-agent frontmatter ignores `permissionMode`, `mcpServers`, and `hooks`** — Security restriction since docs 2.1.78+. Setting them looks valid but silently has no effect. Plugin-agents needing MCP must add a body note that MCP must be configured in the user's session. - **Hard-coded `model:` and `effort:` on