# Plugin Creator

Scaffold a local Codewhale plugin bundle with a versioned manifest, namespaced Skills...

- Repository: https://github.com/codewhale-hq/Codewhale (41164 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add codewhale-hq/Codewhale --skill plugin-creator -g -a claude-code -y`
Codex: `npx skills add codewhale-hq/Codewhale --skill plugin-creator -g -a codex -y`
Cursor: `npx skills add codewhale-hq/Codewhale --skill plugin-creator -g -a cursor -y`
Gemini CLI: `npx skills add codewhale-hq/Codewhale --skill plugin-creator -g -a gemini-cli -y`

## Description

Scaffold a local Codewhale plugin bundle with a versioned manifest, namespaced Skills, and an explicit trust review.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Plugin Creator

Use this skill when a user wants a local Codewhale plugin bundle. Trusted and
enabled bundles may add declarative Skills, commands, agents, hooks, and MCP
servers (stdio and remote) through the existing engines. LSP, filesystem
roots, and lifecycle mutation are inventory-only. Native extensions (host
code) are inventory-only unless the user has turned on the experimental
`[features] extension_host` flag.

## Workflow

1. Pick a Codewhale-owned location:
   - User bundle: `~/.codewhale/plugins/<plugin-name>/`
   - Workspace bundle: `<workspace>/.codewhale/plugins/<plugin-name>/`
2. Normalize the bundle name to lowercase hyphen-case.
3. Create `plugin.json` (Agent Plugins v1.0.0; a legacy `plugin.toml` stays
   readable, but new bundles use `plugin.json`):

```json
{
  "$schema": "https://agent-plugins.org/schemas/plugin.json",
  "name": "my-plugin",
  "version": "0.1.0",
  "description": "What this bundle provides"
}
```

The rest: https://github.com/codewhale-hq/Codewhale/blob/HEAD/crates/skills/assets/skills/plugin-creator/SKILL.md