Practical Guide

mkdir my-first-plugin
mkdir my-first-plugin/.claude-plugin
mkdir my-first-plugin/commands

{
  "name": "my-first-plugin",
  "description": "My first Claude Code plugin",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}

---
description: Send a friendly greeting to the user
---

# Hello Command

Please greet the user warmly and ask what you can help them with today.

claude --plugin-dir ./my-first-plugin

/my-first-plugin:hello

---
description: Send a personalized greeting to a specific user
---

# Hello Command

Please warmly greet the user named "$ARGUMENTS" and ask what you can help them with today.

If the user didn't provide a name, use "friend" as the default.

/my-first-plugin:hello Alice

my-first-plugin/
├── skills/
│   └── code-review/
│       └── SKILL.md

---
name: code-review
description: Review code for quality, security, and maintainability
---

When reviewing code, check the following aspects:

1. **Code organization**: Is the structure clear?
2. **Error handling**: Are exceptions properly handled?
3. **Security concerns**: Are there any security vulnerabilities?
4. **Test coverage**: Is critical logic covered by tests?

Output format:
- Critical issues (must fix)
- Warnings (should fix)
- Suggestions (nice to have)

---
name: code-reviewer
description: Professional code review agent for quality inspection
tools: Read, Grep, Glob, Bash
---

You are an experienced code review expert.

When invoked:
1. Run git diff to see recent changes
2. Analyze modified files
3. Provide structured review feedback

Review checklist:
- Code readability and naming conventions
- Error handling and edge cases
- Security vulnerabilities (e.g., injection, sensitive data exposure)
- Performance optimization opportunities

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/format-code.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# Format code
cd "$CLAUDE_PROJECT_DIR" && make format 2>/dev/null || true

chmod +x scripts/format-code.sh

{
  "mcpServers": {
    "plugin-database": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
      "env": {
        "DB_PATH": "${CLAUDE_PLUGIN_ROOT}/data"
      }
    }
  }
}

my-plugin/
├── .claude-plugin/
│   └── plugin.json           # Plugin manifest
├── commands/
│   ├── review.md             # Code review command
│   ├── deploy.md             # Deployment command
│   └── test.md               # Testing command
├── agents/
│   ├── code-reviewer.md      # Code review agent
│   └── debugger.md           # Debugging agent
├── skills/
│   └── code-standards/
│       └── SKILL.md          # Coding standards knowledge
├── hooks/
│   └── hooks.json            # Event hook configuration
├── scripts/
│   ├── format-code.sh        # Code formatting script
│   └── run-tests.sh          # Test runner script
├── .mcp.json                  # MCP configuration
├── LICENSE
├── README.md
└── CHANGELOG.md

{
  "name": "dev-toolkit",
  "version": "1.0.0",
  "description": "Developer toolkit: an all-in-one solution for code review, testing, and deployment",
  "author": {
    "name": "Your Team",
    "email": "team@example.com"
  },
  "homepage": "https://github.com/you/dev-toolkit",
  "repository": "https://github.com/you/dev-toolkit",
  "license": "MIT",
  "keywords": ["development", "code-review", "deployment"],
  "commands": "./commands/",
  "agents": "./agents/",
  "skills": "./skills/",
  "hooks": "./hooks/hooks.json",
  "mcpServers": "./.mcp.json"
}

{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Name",
    "email": "you@example.com"
  },
  "plugins": [
    {
      "name": "dev-toolkit",
      "source": "./plugins/dev-toolkit",
      "description": "Developer toolkit",
      "version": "1.0.0"
    },
    {
      "name": "doc-generator",
      "source": {
        "source": "github",
        "repo": "you/doc-generator-plugin"
      },
      "description": "Documentation generation tool"
    }
  ]
}

{
  "name": "my-plugin",
  "source": "./plugins/my-plugin"
}

{
  "name": "github-plugin",
  "source": {
    "source": "github",
    "repo": "owner/plugin-repo"
  }
}

{
  "name": "git-plugin",
  "source": {
    "source": "url",
    "url": "https://gitlab.com/team/plugin.git"
  }
}

/plugin

/plugin marketplace add owner/repo           # GitHub
/plugin marketplace add https://example.com/marketplace.json  # URL
/plugin marketplace add ./local-marketplace  # Local

# Install to user scope (default)
/plugin install formatter@my-marketplace

# Install to project scope (shared with team)
/plugin install formatter@my-marketplace --scope project

# Install to local scope (gitignored)
/plugin install formatter@my-marketplace --scope local

/plugin enable <plugin>      # Enable a plugin
/plugin disable <plugin>     # Disable a plugin
/plugin uninstall <plugin>   # Uninstall a plugin
/plugin update <plugin>      # Update a plugin

claude plugin validate .

/plugin validate .

{
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  },
  "enabledPlugins": {
    "code-formatter@company-tools": true,
    "deployment-tools@company-tools": true
  }
}

{
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "company/approved-plugins"
    }
  ]
}