create-plugin

Skill: Plugin Creator (Claude Code + Codex)

Purpose

Scaffold a GitHub repo that works as a plugin for both Claude Code and Codex simultaneously. Outputs ready-to-copy file contents and git commands for every required file.

---

Step 1: Gather Inputs

Ask the user these questions (all at once):

1. Repo name — kebab-case (e.g. my-skills)
2. GitHub username or org — (e.g. alexsmedile)
3. Plugin description — one sentence
4. Author name
5. What does this plugin contain? — pick all that apply:
   • Skills (skills/)
   • Agents (agents/)
   • Hooks (hooks/hooks.json)
   • MCP servers (.mcp.json)
6. License — default: MIT

Do not proceed until you have at least: repo name, GitHub username, description, and author name.

---

Step 2: Generate File Structure

Show the full directory tree based on their selections, then output every file's content ready to copy.

Always-required files

.claude-plugin/plugin.json

{
  "name": "{{repo-name}}",
  "version": "1.0.0",
  "description": "{{description}}",
  "author": {
    "name": "{{author}}"
  },
  "homepage": "https://github.com/{{username}}/{{repo-name}}",
  "repository": "https://github.com/{{username}}/{{repo-name}}",
  "license": "{{license}}",
  "keywords": []
}

Skills and agents in skills/ and agents/ are auto-discovered — no paths needed in plugin.json.

.claude-plugin/marketplace.json

{
  "name": "{{repo-name}}",
  "owner": {
    "name": "{{author}}"
  },
  "metadata": {
    "description": "{{description}}",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "{{repo-name}}",
      "source": "./",
      "description": "{{description}}",
      "version": "1.0.0",
      "author": {
        "name": "{{author}}"
      },
      "homepage": "https://github.com/{{username}}/{{repo-name}}",
      "repository": "https://github.com/{{username}}/{{repo-name}}",
      "license": "{{license}}",
      "category": "productivity"
    }
  ]
}