К основному содержанию
скилл CX Codex

plugin-master — скилл для Claude Code: что делает и как установить

Скилл plugin-master помогает проектировать, валидировать и публиковать плагины для Claude Code со всеми манифестами, хуками и агентами.

MIT 158 установок ★ 66 обновлён 2026-06-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add JosiahSiegel/claude-plugin-marketplace --skill plugin-master -a claude-code
Открыть на GitHub

Что делает plugin-master

Скилл содержит архитектурные стандарты для расширений экосистемы Claude Code. Он описывает схему манифеста plugin.json, структуру каталогов с директориями agents/, commands/, skills/ и hooks/, а также правила регистрации в файле marketplace.json. Без каталога .claude-plugin/ и валидного plugin.json внутри среда просто не загрузит расширение.

Внутри заложена концепция Agent-First, когда ядром выступает агент {domain}-expert, а также трёхуровневая подгрузка контекста для скиллов через тело SKILL.md и папку references/. Если в проект включён сторонний код, руководство требует составить файл NOTICES.md до публикации. Для путей внутри скриптов хуков предписано использовать переменную ${CLAUDE_PLUGIN_ROOT}.

Какие задачи решает

  • спроектировать структуру каталогов и манифест plugin.json по схеме
  • настроить автономных экспертных агентов и команды с обязательным frontmatter
  • сконфигурировать хуки жизненного цикла и подключение MCP-серверов
  • зарегистрировать созданный плагин в репозитории marketplace.json

Примеры запросов агенту

  • Помоги создать плагин для Claude Code с агентом docker-expert и манифестом plugin.json
  • Проверь структуру директорий плагина и подготовь запись для marketplace.json
  • Настрой хук PostToolUse для запуска линтера через ${CLAUDE_PLUGIN_ROOT}

Как установить plugin-master

1Через Skills CLI (Vercel)

npx skills add JosiahSiegel/claude-plugin-marketplace --skill plugin-master -a claude-code

2Вручную: положить файлы

~/.claude/skills/plugin-master/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/plugin-master/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о plugin-master

Как установить plugin-master в Claude Code?

Выполните команду npx skills add JosiahSiegel/claude-plugin-marketplace --skill plugin-master -a claude-code. Файл сохранится в ~/.claude/skills/plugin-master/SKILL.md.

Что делает скилл plugin-master?

Он обучает ассистента правилам сборки плагинов: от проверки типов полей в манифесте до структуры каталогов и регистрации агентов с хуками.

Почему компоненты созданного плагина могут не распознаваться?

Манифест обязан лежать внутри .claude-plugin/, а каждый файл в agents/, commands/ и skills/ должен начинаться с YAML frontmatter с обязательным полем description.

Исходный текст

SKILL.md · MIT
---
name: plugin-master
description: |
  Complete guide to Claude Code plugin development, architecture, directory layout, components, and marketplace publishing.
  PROACTIVELY activate for: (1) creating a plugin from scratch, (2) building or scaffolding a plugin, (3) writing plugin.json, (4) adding commands/agents/skills/hooks/MCP servers, (5) packaging code as a plugin, (6) publishing to a marketplace, (7) validating plugin structure, (8) marketplace.json registration, (9) cross-platform compatibility, (10) version and metadata sync.
  Provides: plugin schema, layouts, workflows, and publishing steps.
---

# Plugin Development Guide

## Quick Reference

| Component | Location | Required |
|-----------|----------|----------|
| Plugin manifest | `.claude-plugin/plugin.json` | Yes |
| Commands | `commands/*.md` | No (auto-discovered) |
| Agents | `agents/*.md` | No (auto-discovered) |
| Skills | `skills/*/SKILL.md` | No (auto-discovered) |
| Hooks | `hooks/hooks.json` | No |
| MCP Servers | `.mcp.json` | No |

| Task | Action |
|------|--------|
| Create plugin | Ask: "Create a plugin for X" |
| Validate plugin | Run: `/validate-plugin` |
| Install from marketplace | `/plugin marketplace add user/repo` then `/plugin install name@user` |

## Critical Rules

### Directory Structure

```text
plugin-name/
├── .claude-plugin/
│   └── plugin.json          # MUST be inside .claude-plugin/
├── agents/
│   └── domain-expert.md
├── commands/
├── skills/
│   └── skill-name/
│       ├── SKILL.md
│       ├── references/
│       └── examples/
└── README.md
```

### Plugin.json Schema

```json
{
  "name": "plugin-name",
  "version": "1.0.0",
  "description": "Complete [domain] expertise. PROACTIVELY activate for: (1) ...",
  "author": {
    "name": "Author Name",
    "email": "[email protected]"
  },
  "license": "MIT",
  "keywords": ["keyword1", "keyword2"]
}
```

**Validation Rules:**
- `author` MUST be an object `{ "name": "..." }` - NOT a string
- `version` MUST be a string `"1.0.0"` - NOT a number
- `keywords` MUST be an array `["word1", "word2"]` - NOT a string
- Do NOT include `agents`, `skills`, `slashCommands` - these are auto-discovered

### YAML Frontmatter (REQUIRED)

ALL markdown files in agents/, commands/, skills/ MUST begin with frontmatter:

```markdown
---
description: Brief description of what this component does
---

# Content...
```

**Without frontmatter, components will NOT load.**

## Plugin Design Philosophy (2025)

### Agent-First Design

- **Primary interface**: ONE expert agent named `{domain}-expert`
- **Minimal commands**: Only 0-2 for automation workflows
- **Why**: Users want conversational interaction, not command menus

**Naming Standard:**
- `docker-master` → agent named `docker-expert`
- `terraform-master` → agent named `terraform-expert`

### Progressive Disclosure for Skills

Skills use three-tier loading:
1. **Frontmatter** - Loaded at startup for triggering
2. **SKILL.md body** - Loaded when skill activates
3. **references/** - Loaded only when specific detail needed

This enables unbounded capacity without context bloat.

## Creating a Plugin

### Step 1: Detect Repository Context

Before creating files, check:
```bash
# Check if in marketplace repo
if [[ -f .claude-plugin/marketplace.json ]]; then
    PLUGIN_DIR="plugins/PLUGIN_NAME"
else
    PLUGIN_DIR="PLUGIN_NAME"
fi

# Get author from git config
AUTHOR_NAME=$(git config user.name)
AUTHOR_EMAIL=$(git config user.email)
```

### Step 2: Create Structure

```bash
mkdir -p $PLUGIN_DIR/.claude-plugin
mkdir -p $PLUGIN_DIR/agents
mkdir -p $PLUGIN_DIR/skills/domain-knowledge
```

### Step 3: Create Files

1. **plugin.json** - Manifest with metadata
2. **agents/domain-expert.md** - Primary expert agent
3. **skills/domain-knowledge/SKILL.md** - Core knowledge
4. **README.md** - Documentation

### Step 4 (conditional): Attribution manifest

If the plugin ships any vendored, derived, or licensed third-party content, create `NOTICES.md` at the plugin root **before** registering in the marketplace. Treat it as a first-class shipping artifact alongside `plugin.json` and `README.md`, not as doc polish. See `references/publishing-guide.md` ("Licensed / Vendored / Derived Content" checklist) for the structural integrity, license-text-preservation, and cross-reference requirements.

If the plugin contains no third-party content, skip this step.

### Step 5: Register in Marketplace

**CRITICAL**: If `.claude-plugin/marketplace.json` exists at repo root, you MUST add the plugin:

```json
{
  "plugins": [
    {
      "name": "plugin-name",
      "source": "./plugins/plugin-name",
      "description": "Same as plugin.json description",
      "version": "1.0.0",
      "author": { "name": "Author" },
      "keywords": ["same", "as", "plugin.json"]
    }
  ]
}
```

## Component Types

### Commands

User-initiated slash commands in `commands/*.md`:

```markdown
---
description: What this command does
---

# Command Name

Instructions for Claude to execute...
```

### Agents

Autonomous subagents in `agents/*.md`:

```markdown
---
name: agent-name
description: |
  Brief role summary. PROACTIVELY activate for: (1) trigger, (2) trigger, ..., (N) trigger. Provides: capability list.

  # Optional. Include 3-5 <example> blocks ONLY when the agent body
  # exceeds 2,500 words. Lean orchestrators omit them by design.
  # See agent-development "Example-block requirement by agent body size".
model: inherit
color: blue
---

System prompt for agent...
```

### Skills

Dynamic knowledge in `skills/skill-name/SKILL.md`:

```markdown
---
name: skill-name
description: When to use this skill...
---

# Skill content with progressive disclosure...
```

### Hooks

Event automation in `hooks/hooks.json`:

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

**Events**: PreToolUse, PostToolUse, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification, Stop, SubagentStop

## Best Practices

### Naming Conventions

- **Plugins**: `kebab-case` (e.g., `code-review-helper`)
- **Commands**: verb-based (e.g., `review-pr`, `run-tests`)
- **Agents**: role-based (e.g., `code-reviewer`, `test-generator`)
- **Skills**: topic-based (e.g., `api-design`, `error-handling`)

### Portability

Use `${CLAUDE_PLUGIN_ROOT}` for all internal paths:

```json
"command": "${CLAUDE_PLUGIN_ROOT}/scripts/run.sh"
```

Never use hardcoded absolute paths.

### Platform Notes

- **Windows**: Use GitHub marketplace installation (local paths may fail)
- **Git Bash/MinGW**: Detect with `$MSYSTEM`, use GitHub method
- **Mac/Linux**: All installation methods work

## Troubleshooting

| Issue | Solution |
|-------|----------|
| Plugin not loading | Check plugin.json is in `.claude-plugin/` |
| Commands missing | Verify frontmatter has `description` field |
| Agent not triggering | Check description has `PROACTIVELY activate for:` enumeration. Add 3-5 `<example>` blocks only if agent body > 2,500 words — see `agent-development` SKILL.md "Example-block requirement by agent body size". Lean orchestrators are exempt. |
| Marketplace not found | Ensure repo is public, check path in marketplace.json |

## Additional Resources

For detailed information, see:

- **`references/manifest-reference.md`** - Complete plugin.json fields
- **`references/component-patterns.md`** - Advanced component patterns
- **`references/publishing-guide.md`** - Marketplace publishing details
- **`examples/minimal-plugin.md`** - Simplest working plugin
- **`examples/full-plugin.md`** - Complete plugin with all features

© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
okx-ai okx Скилл для работы с агентами OKX.AI и маркетплейсом: регистрация, публикация услуг, заказы, подписки и переписка по задаче. CX Codex +1 12 400установок connector-marketplace-strategy Samuel Berthe Скилл connector-marketplace-strategy помогает решить, стоит ли SaaS запускать свой маркетплейс приложений и коннекторов, и описывает модель работы: курирование, партнёры, правила, take-rate, посев. CX Codex +1 10 500установок okx-cex-skill-mp okx Скилл okx-cex-skill-mp для Claude Code ищет и управляет торговыми скиллами из OKX Skills Marketplace. Он включается для поиска, установки, обновления и проверки подписей. CX Codex +1 8 500установок cli-hub-meta-skill HKUDS Скилл cli-hub-meta-skill для Claude Code и других агентов даёт доступ к маркетплейсу CLI-инструментов. Агент ищет, устанавливает и запускает CLI для видео, изображений, 3D, офисных задач и локальных LLM прямо из чата. CX Codex +1 6 300установок plugin-forge softaworks Скилл plugin-forge для Claude Code создаёт и управляет плагинами с правильной структурой, манифестами и интеграцией маркетплейса. Создаёт плагины для распространения и настраивает команды и хуки. CX Codex +1 4 000установок community-publish Starchild-ai-agent Скилл community-publish разделяет выдачу публичного URL, отправку кода на GitHub и добавление проектов в каталог. Пригодится при публикации сервисов и настройке платного доступа. CX Codex +1 4 000установок

Из того же набора96

Весь набор →
aks-automatic-2025 Скилл aks-automatic-2025 для работы с Azure Kubernetes Service в режиме Automatic. Подключает знания о Karpenter, автоскейлинге, workload identity и настройках кластеров 2025 года. CX Codex +1 161установок ado-windows-git-bash-compatibility Скилл ado-windows-git-bash-compatibility для Claude и других агентов: разбирает падения пайплайнов Azure DevOps на Windows-агентах и в Git Bash — конвертацию путей, выбор shell-задачи, переводы строк. CX Codex +1 159установок azure-emulators-2025 Скилл azure-emulators-2025 для Claude Code настраивает локальные эмуляторы Azure в Docker: Azurite, Cosmos DB и SQL Server 2025. Позволяет отлаживать и тестировать без подключения к облаку. CX Codex +1 159установок advanced-features-2025 Скилл advanced-features-2025 для Claude Code настраивает хуки, MCP-серверы и распространение плагинов на уровне репозитория. Описывает сборку плагинов Claude Code для команды. CX Codex +1 159установок deployment-stacks-2025 Скилл deployment-stacks-2025 помогает проектировать и разбирать Azure Deployment Stacks: защиту ресурсов, очистку при удалении из шаблона и команды Azure CLI. CX Codex +1 157установок advanced-patterns Скилл advanced-patterns для Claude Code содержит шаблоны сложных запросов T-SQL для SQL Server и Azure SQL — от рекурсивных CTE до темпоральных таблиц. CX Codex +1 157установок microsoft-guide Скилл microsoft-guide для Claude Code помогает находить рекомендации Microsoft по архитектуре .NET-микросервисов. Он включается при вопросах о DDD, CQRS, интеграционных событиях и развёртывании. CX Codex +1 157установок terraform-tasks Скилл terraform-tasks для автономной работы с Terraform: генерирует код инфраструктуры, собирает CI/CD-пайплайны, мигрирует ресурсы в state и чинит проблемы версий. CX Codex +1 155установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой