Referensi Plugins

​

Referensi komponen plugin

​

Skills

skills/
├── pdf-processor/
│   ├── SKILL.md
│   ├── reference.md (opsional)
│   └── scripts/ (opsional)
└── code-reviewer/
    └── SKILL.md

• Skills dan commands secara otomatis ditemukan saat plugin dipasang
• Claude dapat memanggilnya secara otomatis berdasarkan konteks tugas
• Skills dapat menyertakan file pendukung di samping SKILL.md

​

Agents

---
name: agent-name
description: Apa yang agent ini spesialisasikan dan kapan Claude harus memanggilnya
model: sonnet
effort: medium
maxTurns: 20
disallowedTools: Write, Edit
---

Prompt sistem terperinci untuk agent yang menjelaskan peran, keahlian, dan perilakunya.

• Agents muncul di typeahead @-mention dengan nama yang diberi scope, seperti my-plugin:code-reviewer, setelah plugin diaktifkan
• Claude dapat memanggil agents secara otomatis berdasarkan konteks tugas
• Agents dapat dipanggil secara manual oleh pengguna
• Plugin agents bekerja bersama agents Claude bawaan

​

Hooks

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

• command: jalankan perintah shell atau scripts
• http: kirim JSON event sebagai POST request ke URL
• mcp_tool: panggil tool pada MCP server yang dikonfigurasi
• prompt: evaluasi prompt dengan LLM (menggunakan placeholder $ARGUMENTS untuk konteks)
• agent: jalankan verifier agentic dengan tools untuk tugas verifikasi kompleks

​

MCP servers

{
  "mcpServers": {
    "plugin-database": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
      "env": {
        "DB_PATH": "${CLAUDE_PLUGIN_ROOT}/data"
      }
    },
    "plugin-api-client": {
      "command": "npx",
      "args": ["@company/mcp-server", "--plugin-mode"]
    }
  }
}

• Plugin MCP servers dimulai secara otomatis saat plugin diaktifkan
• Servers muncul sebagai alat MCP standar di toolkit Claude
• Kemampuan server terintegrasi dengan mulus dengan alat Claude yang ada
• Plugin servers dapat dikonfigurasi secara independen dari MCP servers pengguna

​

LSP servers

• Diagnostik instan: Claude melihat kesalahan dan peringatan segera setelah setiap edit
• Navigasi kode: buka definisi, temukan referensi, dan informasi hover
• Kesadaran bahasa: informasi tipe dan dokumentasi untuk simbol kode

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

{
  "name": "my-plugin",
  "lspServers": {
    "go": {
      "command": "gopls",
      "args": ["serve"],
      "extensionToLanguage": {
        ".go": "go"
      }
    }
  }
}

​

Monitors

[
  {
    "name": "deploy-status",
    "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/poll-deploy.sh",
    "description": "Deployment status changes"
  },
  {
    "name": "error-log",
    "command": "tail -F ./logs/error.log",
    "description": "Application error log",
    "when": "on-skill-invoke:debug"
  }
]

​

Themes

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

​

Cakupan instalasi plugin

​

Skills-directory plugins

​

Pilih di mana plugin dimuat

• MCP servers yang dideklarasikannya melalui persetujuan per-server yang sama seperti .mcp.json proyek
• LSP servers dimulai hanya setelah Anda mempercayai workspace
• Background monitors tidak dimuat

​

Edit, reload, dan disable skills-directory plugin

claude plugin disable my-tool@skills-dir

​

Skema manifest plugin

​

Skema lengkap

{
  "name": "plugin-name",
  "displayName": "Plugin Name",
  "version": "1.2.0",
  "description": "Brief plugin description",
  "author": {
    "name": "Author Name",
    "email": "author@example.com",
    "url": "https://github.com/author"
  },
  "homepage": "https://docs.example.com/plugin",
  "repository": "https://github.com/author/plugin",
  "license": "MIT",
  "keywords": ["keyword1", "keyword2"],
  "skills": "./custom/skills/",
  "commands": ["./custom/commands/special.md"],
  "agents": ["./custom/agents/reviewer.md"],
  "hooks": "./config/hooks.json",
  "mcpServers": "./mcp-config.json",
  "outputStyles": "./styles/",
  "lspServers": "./.lsp.json",
  "experimental": {
    "themes": "./themes/",
    "monitors": "./monitors.json"
  },
  "dependencies": [
    "helper-lib",
    { "name": "secrets-vault", "version": "~2.1.0" }
  ]
}

​

Field yang diperlukan

​

Field yang tidak dikenali

claude plugin validate ./my-plugin --strict

​

Field metadata

​

Default enablement

• Pengaturan pengguna: entri untuk plugin di enabledPlugins pada cakupan pengaturan apa pun. Setelah ditulis, itu bertahan di seluruh update dan reinstall plugin, jadi mengubah defaultEnabled dalam rilis kemudian tidak membalik pengguna yang ada.
• Persyaratan dependensi: ketika plugin diperlukan oleh yang lain yang aktif, Claude Code menulis true untuk itu saat waktu instalasi atau enable. Itu memberikannya pengaturan eksplisit, jadi defaultnya tidak lagi berlaku. Lihat Enable or disable a plugin with dependencies.

​

Field jalur komponen

​

Komponen eksperimental

​

User configuration

{
  "userConfig": {
    "api_endpoint": {
      "type": "string",
      "title": "API endpoint",
      "description": "Endpoint API tim Anda"
    },
    "api_token": {
      "type": "string",
      "title": "API token",
      "description": "Token autentikasi API",
      "sensitive": true
    }
  }
}

​

Channels

{
  "channels": [
    {
      "server": "telegram",
      "userConfig": {
        "bot_token": {
          "type": "string",
          "title": "Bot token",
          "description": "Token bot Telegram",
          "sensitive": true
        },
        "owner_id": {
          "type": "string",
          "title": "Owner ID",
          "description": "ID pengguna Telegram Anda"
        }
      }
    }
  ]
}

​

Aturan perilaku jalur

• Menggantikan default: commands, agents, outputStyles, experimental.themes, experimental.monitors. Misalnya, saat manifest menentukan commands, direktori default commands/ tidak dipindai. Untuk menyimpan default dan menambahkan lebih banyak, sertakan secara eksplisit: "commands": ["./commands/", "./extras/"]
• Menambah default: skills. Direktori default skills/ selalu dipindai, dan direktori yang tercantum di skills dimuat bersama dengannya. Pengecualian: untuk entri marketplace yang source-nya diselesaikan ke root marketplace, mendeklarasikan subdirektori khusus menggantikan scan default skills/
• Aturan penggabungan sendiri: hooks, MCP servers, dan LSP servers. Lihat setiap bagian untuk cara beberapa sumber digabungkan

• Semua jalur harus relatif terhadap root plugin dan dimulai dengan ./
• Komponen dari jalur khusus menggunakan aturan penamaan dan namespacing yang sama
• Beberapa jalur dapat ditentukan sebagai array
• Saat jalur skill menunjuk ke direktori yang berisi SKILL.md secara langsung, misalnya "skills": ["./"] menunjuk ke root plugin, field frontmatter name di SKILL.md menentukan nama invokasi skill. Ini memberikan nama stabil terlepas dari direktori instalasi. Jika name tidak diatur di frontmatter, basename direktori digunakan sebagai fallback.

{
  "commands": [
    "./specialized/deploy.md",
    "./utilities/batch-process.md"
  ],
  "agents": [
    "./custom-agents/reviewer.md",
    "./custom-agents/tester.md"
  ]
}

​

Variabel lingkungan

{
  "hooks": {
    "PostToolUse": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/process.sh"
          }
        ]
      }
    ]
  }
}

​

Direktori data persisten

{
  "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\""
          }
        ]
      }
    ]
  }
}

{
  "mcpServers": {
    "routines": {
      "command": "node",
      "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"],
      "env": {
        "NODE_PATH": "${CLAUDE_PLUGIN_DATA}/node_modules"
      }
    }
  }
}

​

Plugin caching dan resolusi file

• Melalui claude --plugin-dir atau claude --plugin-url, untuk durasi sesi.
• Melalui marketplace, dipasang untuk sesi mendatang.

​

Batasan path traversal

​

Bagikan file dalam marketplace dengan symlinks

• Dalam direktori plugin itu sendiri: symlink dipertahankan sebagai symlink relatif dalam cache, sehingga terus diselesaikan ke target yang disalin saat runtime.
• Di tempat lain dalam marketplace yang sama: symlink didereferensikan. Konten target disalin ke cache di tempatnya. Ini memungkinkan direktori skills/ meta-plugin untuk menghubungkan ke skills yang ditentukan oleh plugins lain dalam marketplace.
• Di luar marketplace: symlink dilewati untuk keamanan. Ini mencegah plugins dari menarik file host arbitrer seperti jalur sistem ke dalam cache.

ln -s ../../shared-plugin/skills/foo ./skills/foo

​

Struktur direktori plugin

​

Tata letak plugin standar

enterprise-plugin/
├── .claude-plugin/           # Direktori metadata (opsional)
│   └── plugin.json             # plugin manifest
├── skills/                   # Skills
│   ├── code-reviewer/
│   │   └── SKILL.md
│   └── pdf-processor/
│       ├── SKILL.md
│       └── scripts/
├── commands/                 # Skills sebagai file .md datar
│   ├── status.md
│   └── logs.md
├── agents/                   # Definisi subagent
│   ├── security-reviewer.md
│   ├── performance-tester.md
│   └── compliance-checker.md
├── output-styles/            # Definisi gaya output
│   └── terse.md
├── themes/                   # Definisi tema warna
│   └── dracula.json
├── monitors/                 # Konfigurasi monitor latar belakang
│   └── monitors.json
├── hooks/                    # Konfigurasi hooks
│   ├── hooks.json           # Konfigurasi hook utama
│   └── security-hooks.json  # Hook tambahan
├── bin/                      # Plugin executables ditambahkan ke PATH
│   └── my-tool               # Dapat dipanggil sebagai perintah bare di Bash tool
├── settings.json            # Pengaturan default untuk plugin
├── .mcp.json                # Definisi MCP server
├── .lsp.json                # Konfigurasi LSP server
├── scripts/                 # Hook dan utility scripts
│   ├── security-scan.sh
│   ├── format-code.py
│   └── deploy.js
├── LICENSE                  # File lisensi
└── CHANGELOG.md             # Riwayat versi

​

Referensi lokasi file

​

Referensi perintah CLI

​

plugin init

claude plugin init <name> [options]

• <name>: Nama plugin. Menjadi namespace skill dan nama direktori di bawah ~/.claude/skills/, jadi tidak dapat berisi spasi atau pemisah jalur.

# Scaffold plugin minimal
claude plugin init my-helper

# Scaffold dengan folder skill dan hook
claude plugin init my-helper --with skills hooks

# Timpa scaffold yang ada
claude plugin init my-helper --force

​

plugin install

claude plugin install <plugin> [options]

• <plugin>: Nama plugin atau plugin-name@marketplace-name untuk marketplace tertentu

# Pasang ke cakupan user (default)
claude plugin install formatter@my-marketplace

# Pasang ke cakupan project (dibagikan dengan tim)
claude plugin install formatter@my-marketplace --scope project

# Pasang ke cakupan local (gitignored)
claude plugin install formatter@my-marketplace --scope local

​

plugin uninstall

claude plugin uninstall <plugin> [options]

• <plugin>: Nama plugin atau plugin-name@marketplace-name

​

plugin prune

claude plugin prune [options]

​

plugin enable

claude plugin enable <plugin> [options]

• <plugin>: Nama plugin atau plugin-name@marketplace-name

​

plugin disable

claude plugin disable <plugin> [options]

• <plugin>: Nama plugin atau plugin-name@marketplace-name

​

plugin update

claude plugin update <plugin> [options]

• <plugin>: Nama plugin atau plugin-name@marketplace-name

​

plugin list

claude plugin list [options]

​

plugin details

claude plugin details <name>

• <name>: Nama plugin atau plugin-name@marketplace-name

• Always-on: token yang ditambahkan ke setiap sesi oleh teks daftar plugin, seperti deskripsi skill, deskripsi agent, dan nama perintah, terlepas dari apakah ada komponen yang diaktifkan.
• On-invoke: token yang dihabiskan komponen saat diaktifkan. Ditampilkan per komponen, bukan sebagai total plugin, karena sesi khas hanya mengaktifkan subset komponen.

dependency-guard 1.2.0
  Dependency analysis for Claude Code sessions
  Source: dependency-guard@example-marketplace

Component inventory
  Skills (2)  scan-dependencies, review-changes
  Agents (0)
  Hooks (1)  (harness-only — no model context cost)
  MCP servers (0)
  LSP servers (0)

Projected token cost
  Always-on:   ~180 tok   added to every session

Per-component (rounded)
  component            always-on  on-invoke
  scan-dependencies        ~100      ~2400
  review-changes            ~80      ~1800

  On-invoke cost is paid each time a skill or agent fires.
  Token counts are estimates and may differ from actual usage.

​

plugin tag

claude plugin tag [options]

​

Alat debugging dan pengembangan

​

Perintah debugging

• Plugin mana yang sedang dimuat
• Kesalahan apa pun dalam manifest plugin
• Registrasi skill, agent, dan hook
• Inisialisasi MCP server

​

Masalah umum

​

Contoh pesan kesalahan

• Invalid JSON syntax: Unexpected token } in JSON at position 142: periksa koma yang hilang, koma ekstra, atau string yang tidak dikutip
• Plugin has an invalid manifest file at .claude-plugin/plugin.json. Validation errors: name: Required: field yang diperlukan hilang
• Plugin has a corrupt manifest file at .claude-plugin/plugin.json. JSON parse error: ...: kesalahan sintaks JSON

• Warning: No commands found in plugin my-plugin custom directory: ./cmds. Expected .md files or SKILL.md in subdirectories.: jalur command ada tetapi tidak berisi file command yang valid
• Plugin directory not found at path: ./plugins/my-plugin. Check that the marketplace entry has the correct path.: jalur source di marketplace.json menunjuk ke direktori yang tidak ada
• Plugin my-plugin has conflicting manifests: both plugin.json and marketplace entry specify components.: hapus definisi komponen duplikat atau hapus strict: false di entri marketplace

​

Troubleshooting hook

1. Periksa script dapat dieksekusi: chmod +x ./scripts/your-script.sh
2. Verifikasi baris shebang: Baris pertama harus #!/bin/bash atau #!/usr/bin/env bash
3. Periksa jalur menggunakan ${CLAUDE_PLUGIN_ROOT}: "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/your-script.sh"
4. Uji script secara manual: ./scripts/your-script.sh

1. Verifikasi nama event benar (case-sensitive): PostToolUse, bukan postToolUse
2. Periksa pola matcher cocok dengan alat Anda: "matcher": "Write|Edit" untuk operasi file
3. Konfirmkan tipe hook valid: command, http, mcp_tool, prompt, atau agent

​

Troubleshooting MCP server

1. Periksa command ada dan dapat dieksekusi
2. Verifikasi semua jalur menggunakan variabel ${CLAUDE_PLUGIN_ROOT}
3. Periksa log MCP server: claude --debug menunjukkan kesalahan inisialisasi
4. Uji server secara manual di luar Claude Code

1. Pastikan server dikonfigurasi dengan benar di .mcp.json atau plugin.json
2. Verifikasi server mengimplementasikan protokol MCP dengan benar
3. Periksa timeout koneksi di output debug

​

Kesalahan struktur direktori

my-plugin/
├── .claude-plugin/
│   └── plugin.json      ← Hanya manifest di sini
├── commands/            ← Di level root
├── agents/              ← Di level root
└── hooks/               ← Di level root

1. Jalankan claude --debug dan cari pesan “loading plugin”
2. Periksa bahwa setiap direktori komponen terdaftar di output debug
3. Verifikasi izin file memungkinkan membaca file plugin

​

Referensi distribusi dan versioning

​

Manajemen versi

1. Field version dalam plugin.json plugin
2. Field version dalam entri marketplace plugin dalam marketplace.json
3. Git commit SHA dari sumber plugin, untuk sumber github, url, git-subdir, dan relative-path dalam marketplace yang dihosting git
4. unknown, untuk sumber npm atau direktori lokal yang tidak berada dalam repositori git

​

Lihat juga

• Plugins - Tutorial dan penggunaan praktis
• Plugin marketplaces - Membuat dan mengelola marketplace
• Skills - Detail pengembangan skill
• Subagents - Konfigurasi dan kemampuan agent
• Hooks - Penanganan event dan otomasi
• MCP - Integrasi alat eksternal
• Settings - Opsi konfigurasi untuk plugins