Tambahkan komponen ke plugin

​

Jelajahi direktori plugin

• Skill review dan perintah about
• Subagent security-review
• Hook yang memformat file setelah Claude mengeditnya, dan folder scripts/ yang dipanggilnya
• Monitor log
• Gaya output dan tema warna
• Workflow route-audit
• Executable hello-plugin
• Pengaturan default
• Server MCP lokal dan language server Go

​

Tambahkan setiap jenis komponen

​

Skills

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── review/
        └── SKILL.md

---
description: Reviews a pull request for style and test coverage. Use when asked to review code.
---

Review the changed files. Report style problems first, then missing tests.

• Nama perintah: /<plugin>:<directory>, jadi skills/review/SKILL.md di my-plugin adalah /my-plugin:review. Jika Anda menetapkan name di frontmatter, itu menggantikan segmen terakhir dan awalan plugin tetap. Lihat bagaimana skill mendapatkan nama perintahnya
• Siapa yang memanggilnya: Claude, pengguna, atau keduanya, dikendalikan oleh frontmatter. Lihat Kontrol siapa yang memanggilnya skill

• Direktori tambahan: daftarkan di kunci manifest skills. Mereka menambah pemindaian default skills/ daripada menggantinya, tidak seperti commands dan agents
• Skill tunggal di root plugin: tanpa direktori skills/ dan tanpa kunci manifest skills, SKILL.md di root plugin dimuat sebagai satu skill. Tetapkan name di frontmatter-nya, karena jika tidak, instalasi marketplace menamakan skill setelah cache directory-nya daripada plugin Anda

​

Commands

​

Tentukan perintah di manifest

{
  "name": "my-plugin",
  "commands": {
    "about": {
      "content": "Summarize what this repository does in three sentences.",
      "description": "Summarize the repository"
    }
  }
}

​

Agents

---
name: security-reviewer
description: Reviews code changes for security issues. Use after edits to authentication or input handling.
model: sonnet
---

You are a security reviewer. Read the changed files and report injection, authentication, and secrets-handling risks.

​

Atur agents dalam subfolder

• Frontmatter name: itu menggantikan hanya nama file, jadi name: audit di agents/review/security.md dimuat sebagai my-plugin:review:audit
• Field manifest agents: file yang Anda daftarkan di sana dimuat tanpa nama subfolder, jadi "agents": "./custom/review/security.md" dimuat sebagai my-plugin:security

​

Field frontmatter dalam agent plugin

• Field yang didukung: name, description, model, effort, maxTurns, tools, disallowedTools, skills, memory, background, omitClaudeMd, isolation, color, dan kunci cacheTtl dari experimental. Satu-satunya nilai isolation yang valid adalah "worktree". Lihat field frontmatter yang didukung untuk apa yang dilakukan masing-masing
• Field yang diabaikan: permissionMode, hooks, mcpServers, dan initialPrompt. File agent tidak dapat menambahkan hooks atau server MCP sendiri, jadi tambahkan itu sebagai plugin hooks dan server MCP sebagai gantinya
• Frontmatter yang tidak diuraikan: agent masih dimuat dengan setiap field diabaikan. Itu dinamai setelah file, dan deskripsinya berbunyi Agent from my-plugin plugin. Jalankan claude plugin validate di shell Anda untuk menemukan file-file ini

​

Hooks

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

​

Kapan hook plugin dipecat

​

Lingkungan, quoting, dan pencocokan tool MCP

• Lingkungan: setiap proses hook menerima CLAUDE_PLUGIN_ROOT dan CLAUDE_PLUGIN_DATA di lingkungannya, ditambah CLAUDE_PLUGIN_OPTION_<KEY> untuk setiap nilai konfigurasi pengguna, sehingga script Anda dapat membacanya dari sana
• Quoting: ketika command tidak memiliki args, itu berjalan melalui shell, jadi bungkus jalur ${CLAUDE_PLUGIN_ROOT} dalam tanda kutip ganda, seperti contoh hooks/hooks.json di bawah Hooks, untuk menjaga jalur yang diperluas sebagai satu kata shell. Ketika Anda melewatkan args sebagai gantinya, setiap elemen dilewatkan sebagai satu argumen tanpa shell dan tidak memerlukan quoting. Lihat exec form dan shell form
• Pencocokan tool MCP plugin sendiri: tool dari server MCP yang dideklarasikan plugin ini dinamai mcp__plugin_<plugin>_<server>__<tool>, jadi tulis nama lengkap itu di matcher. Matcher pada nama server saja tidak pernah dipecat. Lihat Match MCP tools

​

Server MCP

{
  "mcpServers": {
    "db": {
      "command": "node",
      "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"]
    }
  }
}

​

Jangkau pengguna di claude.ai dan Cowork

​

Nama server, nama tool, dan reload

• Nama server: plugin:<plugin>:<server>, jadi server db di my-plugin adalah plugin:my-plugin:db di /mcp. Gunakan bentuk yang sama untuk menamakan server dalam hook mcp_tool
• Nama tool: mcp__plugin_<plugin>_<server>__<tool>, jadi tool query pada server db itu adalah mcp__plugin_my-plugin_db__query. Itu adalah nama yang digunakan dalam aturan izin dan matcher hook
• Substitusi: ${CLAUDE_PLUGIN_ROOT} dan variabel jalur lainnya disubstitusikan dalam command, args, dan env. Tidak ada quoting yang diperlukan dalam args, karena setiap elemen dilewatkan sebagai satu argumen
• Reload: ketika pengguna menjalankan /reload-plugins dan reload berlaku, server yang konfigurasinya tidak berubah menjaga koneksinya. Server yang konfigurasinya berubah terhubung kembali, dan yang Anda hapus terputus

​

Sertakan server MCPB yang dikemas

{
  "name": "my-plugin",
  "mcpServers": "./servers/db.mcpb"
}

​

Server LSP

{
  "gopls": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

• Binary yang hilang: Claude Code memulai command berdasarkan nama dari PATH pengguna. Ketika binary tidak ada, server gagal dimulai dan claude --debug mencatat LSP server <name> failed to start
• Konflik ekstensi: ketika dua server yang diaktifkan mengklaim ekstensi yang sama, yang pertama terdaftar menangani file-file itu dan yang lain tidak digunakan untuk mereka, apakah server berasal dari satu plugin atau dua. Tab Errors /plugin menunjukkan peringatan LSP server "<name>" is not used for <ext> files

​

Executables

#!/bin/bash
echo "hello from my-plugin"

​

Pengaturan default

{
  "agent": "security-reviewer"
}

• File atas manifest: ketika keduanya ada dan settings.json menetapkan setidaknya satu kunci yang didukung, settings.json berlaku dan settings manifest diabaikan
• Pengaturan pengguna atas default plugin: di seluruh sumber pengaturan, default plugin adalah layer terendah, jadi agent pengguna sendiri di ~/.claude/settings.json menggantikan milik Anda
• Dua plugin menetapkan kunci yang sama: nilai dari plugin yang dimuat terakhir berlaku, dan claude --debug mencatat overrides setting

​

Tema dan output styles

{
  "name": "Dracula",
  "base": "dark",
  "overrides": {
    "claude": "#bd93f9",
    "error": "#ff5555"
  }
}

​

Channels

{
  "name": "my-plugin",
  "mcpServers": {
    "telegram": {
      "command": "node",
      "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"],
      "env": { "BOT_TOKEN": "${user_config.bot_token}" }
    }
  },
  "channels": [
    {
      "server": "telegram",
      "userConfig": {
        "bot_token": {
          "type": "string",
          "title": "Bot token",
          "description": "Telegram bot token",
          "sensitive": true
        }
      }
    }
  ]
}

​

Monitors

[
  {
    "name": "error-log",
    "command": "tail -F ./logs/error.log",
    "description": "Application error log"
  }
]

• Sesi interaktif saja: monitor plugin dimulai dalam sesi interaktif dan tidak pernah dalam mode non-interaktif dengan flag -p. Mereka juga dimulai hanya di mana Monitor tool tersedia
• Tidak ada konfigurasi pengguna: command mendapat variabel jalur dan ${ENV_VAR} dari lingkungan, tetapi tidak pernah ${user_config.*}. Monitor yang mereferensikan satu tidak dimulai, dan proses monitor tidak menerima CLAUDE_PLUGIN_OPTION_<KEY> juga
• Menonaktifkan mid-session: jika Anda menonaktifkan plugin mid-session, Claude Code tidak menghentikan monitor yang sudah berjalan. Mereka berhenti ketika sesi berakhir

​

Minta pengguna untuk nilai konfigurasi

{
  "name": "my-plugin",
  "userConfig": {
    "api_url": {
      "type": "string",
      "title": "API URL",
      "description": "Base URL of your team's API"
    },
    "api_token": {
      "type": "string",
      "title": "API token",
      "description": "Token for your team's API",
      "sensitive": true
    }
  }
}

​

Kapan dialog konfigurasi muncul

• Memasang plugin di /plugin
• Menjalankan /plugin install <plugin>@<marketplace> di dalam sesi
• Mengaktifkan plugin dari tab Installed di /plugin

​

Referensikan jalur plugin dan simpan data

• ${CLAUDE_PLUGIN_ROOT}: direktori instalasi plugin. Setiap versi memiliki cache directory-nya sendiri, jadi jalur berubah ketika plugin diperbarui. Jangan tulis state di sana
• ${CLAUDE_PLUGIN_DATA}: direktori yang bertahan dari update, untuk node_modules, virtual environments, dan caches. Itu diselesaikan ke ~/.claude/plugins/data/<id>/ dan dibuat ketika pertama kali direferensikan
• ${CLAUDE_PROJECT_DIR}: root proyek, nilai yang sama yang diterima hooks

​

Pasang dependensi ke direktori data

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "diff -q \"${CLAUDE_PLUGIN_ROOT}/package.json\" \"${CLAUDE_PLUGIN_DATA}/package.json\" >/dev/null 2>&1 || (cd \"${CLAUDE_PLUGIN_DATA}\" && cp \"${CLAUDE_PLUGIN_ROOT}/package.json\" . && npm install) || rm -f \"${CLAUDE_PLUGIN_DATA}/package.json\""
          }
        ]
      }
    ]
  }
}

​

Langkah berikutnya

• Referensi manifest plugin: field plugin.json, aturan jalur, dan layout standar
• Test plugins dengan evals: periksa bahwa komponen yang Anda tambahkan mengubah perilaku Claude dengan cara yang Anda maksudkan
• Publikasikan dan distribusikan plugin: versi plugin dan letakkan di marketplace
• Troubleshoot plugins: apa yang harus dilakukan ketika komponen tidak dimuat atau hook tidak dipecat