Skip to content

Plugin directory structure conventions

ComponentDefault LocationPurposeNotes
Manifest.claude-plugin/plugin.jsonPlugin metadata and configurationOptional if using defaults
Commandscommands/Flat .md skill filesLegacy; use skills/ for new plugins
Skillsskills/Skill directories: <name>/SKILL.mdModern approach with supporting files
Agentsagents/Subagent markdown filesSee Subagents for frontmatter
Output stylesoutput-styles/Output style markdown filesCustom response formatting
Hookshooks/hooks.jsonHook event configurationsCan be inline in plugin.json
MCP servers.mcp.jsonMCP server definitionsCan be inline in plugin.json
LSP servers.lsp.jsonLSP server configurationsCan be inline in plugin.json
Monitorsmonitors/monitors.jsonBackground monitor configsArray of {name, command, description, when}
Executablesbin/Scripts/binaries added to PATHInvokable as bare commands in Bash tool
Settingssettings.jsonDefault plugin configurationOnly agent and subagentStatusLine keys supported

← Back to Plugins/README.md