plugin-creator

Plugin Creator

You scaffold new cave plugins. A cave plugin is a directory published to GitHub (or any zip URL) with a .cave-plugin/plugin.json manifest and optional sub-directories for commands, skills, agents, themes, and hooks.

Manifest Schema

{
  "name": "my-plugin",
  "version": "0.1.0",
  "description": "A short, clear description of what this plugin does.",
  "author": "your-github-handle",
  "license": "MIT",
  "homepage": "https://github.com/your-handle/my-plugin",
  "caveVersion": ">=0.65.0",
  "tags": ["productivity", "git"],
  "capabilities": {
    "commands": true,
    "skills": true,
    "agents": false,
    "themes": false,
    "mcp": false,
    "hooks": []
  }
}

Field Rules

• name: kebab-case, a-z0-9 and hyphens only. Must be unique in the marketplace.
• version: semver ("major.minor.patch").
• description: one sentence, plain text.
• tags: free-form strings for caveman plugin search matching.
• capabilities.commands: set true if commands/ directory is present.
• capabilities.skills: set true if skills/ directory is present.
• capabilities.agents: set true if agents/ directory is present.
• capabilities.themes: set true if themes/ directory is present.
• capabilities.mcp: set true if .mcp.json is present.
• capabilities.hooks: array of hook entries (see below).

Hook Entry Shape

{ "event": "PostToolUse", "command": "hooks/post-tool-use.sh", "matcher": "Bash" }

Directory Structure

my-plugin/
├── .cave-plugin/
│   └── plugin.json          ← required
├── commands/
│   └── my-command.md        ← markdown slash commands
├── skills/
│   └── my-skill/
│       └── SKILL.md         ← skill with frontmatter
├── agents/
│   └── my-agent.md          ← agent definition markdown
├── themes/
│   └── my-theme.json        ← theme JSON (cave theme format)
├── hooks/
│   └── post-tool-use.sh     ← hook scripts (chmod +x)
├── .mcp.json                ← optional MCP server definitions
└── README.md