agent-plugin-template

⚡ Quick Start

1. Create your plugin

# Clone this template
git clone https://github.com/your-username/my-plugin.git
cd my-plugin

# Install dependencies (for TypeScript hooks/scripts)
npm install

# Make scripts executable
npm run prepare

2. Develop and Test

Test your plugin instantly in your current session:

claude --plugin-dir .

3. Verify

Check for configuration errors:

claude plugin validate

---

🏗️ Project Structure

This template follows the Standard Plugin Layout.

graph TD
    Root[Plugin Root] --> Manifest[.claude-plugin/plugin.json]
    Root --> Skills[skills/]
    Root --> Agents[agents/]
    Root --> Hooks[hooks/]
    Root --> MCP[.mcp.json]
    Root --> LSP[.lsp.json]

    Skills --> MySkill[my-skill/SKILL.md]
    Agents --> MyAgent[my-agent.md]
    Hooks --> HookConfig[hooks.json]
    Hooks --> Scripts[scripts/*.ts]

    style Root fill:#f9f9f9,stroke:#333,stroke-width:2px
    style Manifest fill:#e1f5fe,stroke:#01579b
    style Skills fill:#e8f5e9,stroke:#2e7d32
    style Agents fill:#fff3e0,stroke:#ef6c00

---

🧩 Components

🧠 Skills (skills/)

Reusable workflows invoked automatically or via /slash-command.

• Path: skills/<name>/SKILL.md
• Tip: Keep them focused on a single capability.

🤖 Agents (agents/)

Specialized sub-agents for complex, multi-step tasks.

• Path: agents/<name>.md
• Config: YAML frontmatter + System Prompt.

🪝 Hooks (hooks/)

Event-driven automation (e.g., SessionStart, PreToolUse).

• Config: hooks/hooks.json
• Scripting: Use ${CLAUDE_PLUGIN_ROOT} for paths.

🔌 Connectivity

• MCP Servers (.mcp.json): Connect external tools & APIs.
• LSP Servers (.lsp.json): Add language intelligence.

---

🛠️ Configuration

Plugin Manifest (.claude-plugin/plugin.json)

{
  "name": "my-plugin",
  "version": "0.1.0",
  "description": "My awesome plugin",
  "skills": "./skills/",
  "agents": "./agents/",
  "hooks": "./hooks/hooks.json"
}

---

📦 Distribution

1. Commit your changes.
2. Update .claude-plugin/marketplace.json.
3. Install:

   claude plugin install <plugin-name>@<marketplace-url>
   

🔍 Troubleshooting

Issue	Solution
Plugin not loading	Run claude --debug to see logs
Command fails	chmod +x your scripts
Path errors	Use ${CLAUDE_PLUGIN_ROOT} env var