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 antarmuka /agents
• 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
• 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"],
      "cwd": "${CLAUDE_PLUGIN_ROOT}"
    }
  }
}

• 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"
      }
    }
  }
}

​

Cakupan instalasi plugin

​

Skema manifest plugin

​

Skema lengkap

{
  "name": "plugin-name",
  "version": "1.2.0",
  "description": "Brief plugin description",
  "author": {
    "name": "Author Name",
    "email": "[email protected]",
    "url": "https://github.com/author"
  },
  "homepage": "https://docs.example.com/plugin",
  "repository": "https://github.com/author/plugin",
  "license": "MIT",
  "keywords": ["keyword1", "keyword2"],
  "commands": ["./custom/commands/special.md"],
  "agents": "./custom/agents/",
  "skills": "./custom/skills/",
  "hooks": "./config/hooks.json",
  "mcpServers": "./mcp-config.json",
  "outputStyles": "./styles/",
  "lspServers": "./.lsp.json"
}

​

Field yang diperlukan

​

Field metadata

​

Field jalur komponen

​

User configuration

{
  "userConfig": {
    "api_endpoint": {
      "description": "Endpoint API tim Anda",
      "sensitive": false
    },
    "api_token": {
      "description": "Token autentikasi API",
      "sensitive": true
    }
  }
}

​

Channels

{
  "channels": [
    {
      "server": "telegram",
      "userConfig": {
        "bot_token": { "description": "Token bot Telegram", "sensitive": true },
        "owner_id": { "description": "ID pengguna Telegram Anda", "sensitive": false }
      }
    }
  ]
}

​

Aturan perilaku jalur

• Jika commands/ ada, itu dimuat selain jalur command khusus
• Semua jalur harus relatif terhadap root plugin dan dimulai dengan ./
• Commands dari jalur khusus menggunakan aturan penamaan dan namespacing yang sama
• Beberapa jalur dapat ditentukan sebagai array untuk fleksibilitas

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

​

Caching plugin dan resolusi file

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

​

Batasan path traversal

​

Bekerja dengan dependensi eksternal

# Di dalam direktori plugin Anda
ln -s /path/to/shared-utils ./shared-utils

​

Struktur direktori plugin

​

Tata letak plugin standar

enterprise-plugin/
├── .claude-plugin/           # Direktori metadata (opsional)
│   └── plugin.json             # plugin manifest
├── commands/                 # Lokasi command default
│   ├── status.md
│   └── logs.md
├── agents/                   # Lokasi agent default
│   ├── security-reviewer.md
│   ├── performance-tester.md
│   └── compliance-checker.md
├── skills/                   # Agent Skills
│   ├── code-reviewer/
│   │   └── SKILL.md
│   └── pdf-processor/
│       ├── SKILL.md
│       └── scripts/
├── hooks/                    # Konfigurasi hook
│   ├── hooks.json           # Konfigurasi hook utama
│   └── security-hooks.json  # Hook tambahan
├── 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 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 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

​

Alat debugging dan pengembangan

​

Perintah debugging

• Plugin mana yang sedang dimuat
• Kesalahan apa pun dalam manifest plugin
• Registrasi command, 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, 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

{
  "name": "my-plugin",
  "version": "2.1.0"
}

• MAJOR: Perubahan breaking (perubahan API yang tidak kompatibel)
• MINOR: Fitur baru (penambahan yang kompatibel ke belakang)
• PATCH: Perbaikan bug (perbaikan yang kompatibel ke belakang)

• Mulai dari 1.0.0 untuk rilis stabil pertama Anda
• Perbarui versi di plugin.json sebelum mendistribusikan perubahan
• Dokumentasikan perubahan dalam file CHANGELOG.md
• Gunakan versi pre-release seperti 2.0.0-beta.1 untuk pengujian

​

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