Scaffold a New Plugin

Create a new plugin with all the required files and registry wiring so it is ready for skills to be added.

When to Use

• Creating a brand new plugin in this repository
• User asks to "scaffold", "create", or "set up" a new plugin

When NOT to Use

• Adding skills to an existing plugin (just create the skill directory and SKILL.md)
• Modifying an existing plugin's metadata (edit plugin.json directly)
• Renaming or moving a plugin

Workflow

1. Gather Plugin Information

Ask the user for the plugin name if not already provided. The name must:

• Use kebab-case
• Be prefixed with trogonstack-
• Be concise and descriptive

Ask for a one-line description if not already provided.

2. Create Plugin Directory Structure

plugins/{plugin-name}/
├── .claude-plugin/
│   └── plugin.json
├── .cursor-plugin/
│   └── plugin.json
├── plugin.json       (Agent Plugins manifest)
├── skills/           (empty, ready for skills)
└── README.md

Do NOT create a CHANGELOG.md — release-please manages that automatically.

3. Create plugin.json

{
  "name": "{plugin-name}",
  "description": "{description}",
  "version": "0.0.1",
  "author": {
    "name": "TrogonStack",
    "url": "https://github.com/TrogonStack"
  }
}

4. Create Cursor plugin.json

Create plugins/{plugin-name}/.cursor-plugin/plugin.json. The name, description, and version must match .claude-plugin/plugin.json exactly. The file must satisfy schemas/cursor-plugin/plugin.schema.json, which rejects unknown fields such as author.url.

{
  "name": "{plugin-name}",
  "displayName": "TrogonStack {Human Name}",
  "description": "{description}",
  "version": "0.0.1",
  "author": {
    "name": "TrogonStack"
  },
  "homepage": "https://github.com/TrogonStack/agentskills/tree/main/plugins/{plugin-name}",
  "repository": "https://github.com/TrogonStack/agentskills",
  "license": "MIT",
  "keywords": ["trogonstack", "{topic}"],
  "category": "developer-tools",
  "tags": ["{topic}"],
  "skills": "./skills/"
}

5. Create Agent Plugins plugin.json

Create plugins/{plugin-name}/plugin.json following the Agent Plugins 1.0.0 spec. The name, description, and version must match .claude-plugin/plugin.json exactly, and it must satisfy schemas/agent-plugins/1.0.0/plugin.schema.json. Skills are discovered from the fixed skills/ location, so do not declare component paths.

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "{plugin-name}",
  "version": "0.0.1",
  "description": "{description}",
  "author": {
    "name": "TrogonStack",
    "url": "https://github.com/TrogonStack"
  },
  "homepage": "https://github.com/TrogonStack/agentskills/tree/main/plugins/{plugin-name}",
  "repository": "https://github.com/TrogonStack/agentskills",
  "license": "MIT",
  "keywords": ["trogonstack", "{topic}"]
}

6. Create README.md

# {plugin-name}

{description}

```bash
claude plugin install {plugin-name}@trogonstack
```

7. Register in Marketplaces

Add an entry to .claude-plugin/marketplace.json in the plugins array:

{
  "name": "{plugin-name}",
  "description": "{description}",
  "source": "./plugins/{plugin-name}",
  "category": "development"
}

Add an entry to .cursor-plugin/marketplace.json in the plugins array, with the same description as the Claude marketplace entry:

{
  "name": "{plugin-name}",
  "source": "plugins/{plugin-name}",
  "description": "{description}"
}

8. Register in Release Please Config

Add the package to .github/release-please-config.json in the packages object:

"plugins/{plugin-name}": {
  "component": "{plugin-name}"
}

9. Register in Release Please Manifest

Add the initial version to .github/release-please-manifest.json:

"plugins/{plugin-name}": "0.0.1"

It must be 0.0.1.

10. Commit

Use conventional commit format:

feat({plugin-name}): scaffold plugin for {short purpose}

Quality Checklist

• Plugin directory exists at plugins/{plugin-name}/
• plugins/{plugin-name}/.claude-plugin/plugin.json exists with correct name, description, version 0.0.1, and author
• plugins/{plugin-name}/.cursor-plugin/plugin.json exists with name, description, and version matching the Claude manifest
• plugins/{plugin-name}/plugin.json exists with name, description, and version matching the Claude manifest
• plugins/{plugin-name}/README.md exists with install command
• plugins/{plugin-name}/skills/ directory exists (empty)
• No CHANGELOG.md was created
• .claude-plugin/marketplace.json and .cursor-plugin/marketplace.json have the new plugin entry
• node scripts/validate-plugins.mjs passes
• .github/release-please-config.json has the new package
• .github/release-please-manifest.json has the new version entry at 0.0.1
• Description is consistent across all three plugin.json files, both marketplace.json files, and README.md