{plugin-name}/
├── .claude-plugin/           # メタデータ（必須）
│   └── plugin.json          # マニフェスト（必須）
├── commands/                 # スラッシュコマンド
│   └── {command}.md
├── agents/                   # サブエージェント
│   └── {agent}.md
├── skills/                   # スキル
│   └── {skill-name}/
│       └── SKILL.md
├── hooks/                    # イベントフック
│   └── hooks.json
├── .mcp.json                 # MCP サーバー設定
└── .lsp.json                 # LSP サーバー設定

{
  "name": "plugin-name",           // 必須: 識別子（kebab-case）
  "version": "1.0.0",              // セマンティックバージョン
  "description": "説明",
  "author": {
    "name": "Author Name",         // author 指定時は name 必須
    "email": "email@example.com",
    "url": "https://..."
  },
  "homepage": "https://...",
  "repository": "https://...",
  "license": "MIT",
  "keywords": ["tag1", "tag2"],
  "commands": "./commands/",       // カスタムパス指定可
  "agents": "./agents/",
  "skills": "./skills/",
  "hooks": "./hooks/hooks.json",
  "mcpServers": "./.mcp.json",
  "lspServers": "./.lsp.json"
}

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
argument-hint: [message]
description: Git コミットを作成する
model: claude-haiku-4-5-20251001
disable-model-invocation: false
context: fork
---

# コマンド本体

$ARGUMENTS

allowed-tools:
  - Bash(git add:*)
  - Bash(git commit:*)
  - Read

# 全引数
$ARGUMENTS

# 位置引数
PR #$1 をレビュー（優先度: $2、担当: $3）

---
name: agent-name
description: いつ呼ばれるかの説明
tools: Read, Glob, Grep, Bash     # 省略時は全ツール継承
model: haiku                       # haiku | opus | inherit
permissionMode: default            # default | permissive | strict（v2.0.43+）
skills: skill1, skill2
disallowedTools:                   # 禁止ツールリスト（v2.0.30+）
  - write_file
  - dangerous_command
hooks:                             # エージェント固有フック（v2.1.0+）
  PreToolUse:
    - command: "validate.sh"
  Stop:
    - type: prompt
      prompt: "レビューを実行"
---

# システムプロンプト

エージェントへの指示をここに記述。

disallowedTools:
  - write_file
  - run_shell_command
  - Task(DangerousAgent)

hooks:
  PreToolUse:
    - command: "echo $CLAUDE_HOOK_TOOL_NAME"
  PostToolUse:
    - command: "validate-output.sh"
  Stop:
    - type: prompt
      prompt: "タスク完了レビュー"

{
  "permissions": {
    "deny": ["Task(DangerousAgent)"]
  }
}

---
name: skill-name                    # 必須: 小文字、数字、ハイフンのみ（最大64文字）
description: スキルの説明            # 必須: いつ使うか明記（最大1024文字）
allowed-tools: Read, Grep, Glob     # オプション: 使用可能ツール制限
context: fork                       # オプション: サブエージェントとして実行（v2.1.0+）
agent: custom-agent                 # オプション: 実行エージェント指定（v2.1.0+）
user-invocable: true                # オプション: スラッシュメニュー表示制御（v2.1.3+）
hooks:                              # オプション: スキル固有フック（v2.1.0+）
  PreToolUse:
    - command: "validate.sh"
---

# スキル名

## Instructions
明確なステップバイステップの指示

## Examples
具体的な使用例

---
name: web-research
description: Web検索を実行
context: fork
agent: researcher
---

description: Extract text and tables from PDF files, fill forms, merge documents.
Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.

description: Helps with documents

# agents/code-reviewer.md
---
name: code-reviewer
description: コードレビュー専門
skills: pr-review, security-check   # 明示的に指定
---

~/.claude/settings.json          # ユーザー全体（優先度：低）
.claude/settings.json            # プロジェクト（優先度：中）
.claude/settings.local.json      # ローカル専用（優先度：高、.gitignore対象）

{
  "hooks": {
    "EventName": [
      {
        "matcher": "ToolPattern",
        "hooks": [
          {
            "type": "command",
            "command": "your-command-here",
            "timeout": 600,
            "once": true
          }
        ]
      }
    ]
  }
}

// Command: シェルコマンド実行
{ "type": "command", "command": "bash-command" }

// Prompt: LLM 評価
{ "type": "prompt", "prompt": "LLM に送信するプロンプト" }

// Agent: サブエージェント実行
{ "type": "agent", ... }

---
name: my-agent
hooks:
  PreToolUse:
    - command: "echo $CLAUDE_HOOK_TOOL_NAME"
  PostToolUse:
    - command: "validate-output.sh"
  Stop:
    - type: prompt
      prompt: "タスク完了レビュー"
---

{
  "type": "command",
  "command": "setup.sh",
  "once": true
}

{
  "session_id": "string",
  "transcript_path": "path/to/transcript.json",
  "cwd": "current/working/directory",
  "hook_event_name": "PreToolUse|PostToolUse|...",
  "tool_name": "Write",
  "tool_input": {...},
  "tool_response": {...},
  "tool_use_id": "string"
}

{
  "continue": true,
  "stopReason": "停止理由",
  "suppressOutput": false,
  "systemMessage": "ユーザーへの警告",
  "permissionDecision": "allow|deny|ask",
  "permissionDecisionReason": "理由",
  "updatedInput": { "field": "modified_value" },
  "decision": "block"
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "if [[ \"$CLAUDE_COMMAND\" == *\"rm -rf\"* ]]; then echo 'Blocked' && exit 2; fi"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "prettier --write \"$CLAUDE_FILE_PATHS\" 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}

export ENABLE_LSP_TOOL=1

{
  "typescript": {
    "command": "typescript-language-server",
    "args": ["--stdio"],
    "file_extensions": ["ts", "tsx", "js", "jsx"]
  },
  "python": {
    "command": "pyright-langserver",
    "args": ["--stdio"],
    "file_extensions": ["py"]
  },
  "rust": {
    "command": "rust-analyzer",
    "args": [],
    "file_extensions": ["rs"]
  }
}

# TypeScript
npm install -g typescript-language-server

# Python
pip install pyright

# Rust
rustup component add rust-analyzer

{
  "language": "japanese"
}

.claude/
├── settings.json
├── CLAUDE.md
└── rules/
    ├── api-rules.md
    ├── frontend-rules.md
    └── test-rules.md

---
paths:
  - "src/api/**/*"
  - "tests/api/**/*"
---

# API 開発ルール

- REST API の命名規則に従う
- エラーハンドリングを必ず実装
- テストカバレッジ 80% 以上

{
  "permissions": {
    "allow": ["Tool1", "Tool2(pattern)"],
    "deny": ["Tool3"],
    "ask": ["Tool4"]
  }
}

{
  "permissions": {
    "allow": [
      "Bash(npm *)",
      "Bash(* install)",
      "Bash(git * main)"
    ]
  }
}

{
  "permissions": {
    "allow": ["mcp__server__*"]
  }
}

{
  "permissions": {
    "deny": ["Task(DangerousAgent)"]
  }
}

# サーバー追加
claude mcp add <name> <command>

# サーバー一覧
claude mcp list

# サーバー削除
claude mcp remove <name>

# サーバー有効化/無効化
/mcp enable <server-name>
/mcp disable <server-name>

/vim

/rename my-feature-session

# REPL内
/resume my-feature-session

# CLI
claude --resume my-feature-session

claude --session-id custom-id --resume old-session --fork-session

/plan

{
  "name": "marketplace-name",
  "owner": {
    "name": "Owner Name"
  },
  "plugins": [
    {
      "name": "plugin-name",
      "source": "./plugins/plugin-name",
      "description": "説明"
    }
  ]
}

// 相対パス
"source": "./plugins/my-plugin"

// GitHub（ブランチ指定可）
"source": { "source": "github", "repo": "owner/repo#branch" }

// URL
"source": { "source": "url", "url": "https://..." }

# インタラクティブ
/plugin install

# 直接指定
claude plugin install plugin-name@marketplace

# スコープ指定
claude plugin install plugin-name@marketplace --scope project

# ローカルプラグインをロード
claude --plugin-dir ./my-plugin

# 検証
claude plugin validate .
/plugin validate .

# スキル確認
What Skills are available?

# デバッグモード
claude --debug

# プラグインスキルが表示されない場合
rm -rf ~/.claude/plugins/cache
/plugin install plugin-name@marketplace