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

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

Скилл optimize-plugin проверяет структуру плагинов Claude, запускает Python-валидатор и исправляет найденные ошибки через агента. Пригодится при подготовке и рефакторинге расширений.

MIT 117 установок ★ 597 обновлён 2026-10-09

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

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

Скилл проводит трёхфазный аудит каталога плагина. Сначала он находит манифест .claude-plugin/plugin.json, сканирует папки commands/, agents/, skills/ и hooks/, сверяет компоненты с эталонными шаблонами и запускает скрипт python3 validate-plugin.py с проверкой структуры, манифеста, фронтматтера и бюджетов токенов. Если обнаруживаются старые команды в формате .md, инструмент предлагает мигрировать их в структуру скиллов.

На втором шаге сам оркестратор ничего не правит: он передаёт отчёт агенту plugin-optimizer:plugin-optimizer. Агент согласует изменения шаблонов с пользователем через AskUserQuestion, вносит правки и поднимает версию в манифесте по semver. Завершается работа повторной проверкой, обновлением README.md и составлением итогового отчёта с раскладкой по лимитам токенов. Без установленного python3 и вспомогательного агента запустить проверку не получится.

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

  • проверить плагин Claude на соответствие манифесту и структуре
  • обнаружить превышение лимитов токенов в файлах SKILL.md
  • обновить версию в .claude-plugin/plugin.json по semver после правок
  • сформировать отчёт валидации с разбором критических ошибок

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

  • Проверь плагин в папке ./my-plugin и оптимизируй структуру
  • Запусти валидацию плагина по пути ../custom-tools
  • Проверь качество плагина в каталоге plugins/github-helper и исправь ошибки

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

1Через Skills CLI (Vercel)

npx skills add FradSer/dotclaude --skill optimize-plugin -a claude-code

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

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

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

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

Вопросы об optimize-plugin

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

Выполните в терминале команду npx skills add FradSer/dotclaude --skill optimize-plugin -a claude-code.

Что делает optimize-plugin?

Скилл проверяет структуру плагина, запускает скрипт validate-plugin.py, передаёт найденные проблемы агенту для автоматического исправления и обновляет документацию.

Что нужно для работы скилла?

В системе должен быть установлен python3 для запуска скрипта валидации, а также сопутствующий агент plugin-optimizer:plugin-optimizer.

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

SKILL.md · MIT
---
name: optimize-plugin
description: This skill should be used when the user asks to "validate a plugin", "optimize plugin", "check plugin quality", "review plugin structure", or "run plugin optimizer".
argument-hint: <plugin-path>
user-invocable: true
allowed-tools: ["Read", "Glob", "Bash(realpath:*)", "Bash(python3:*)", "AskUserQuestion", "TaskCreate", "TaskUpdate", "Skill", "Task"]
---

# Plugin Optimization

Execute plugin validation and optimization workflow. **Target:** $ARGUMENTS

## Background Knowledge

Load `plugin-optimizer:plugin-best-practices` skill using the Skill tool for component templates, tool invocation rules, and type classification.

## Phase 1: Discovery & Validation

**Goal**: Validate structure and detect issues. Orchestrator MUST NOT apply fixes.

**Actions**:
1. Resolve path with `realpath` and verify existence
2. Validate `.claude-plugin/plugin.json` exists
3. Find component directories: `commands/`, `agents/`, `skills/`, `hooks/`
4. Validate components against `${CLAUDE_PLUGIN_ROOT}/examples/` templates
5. Assess architecture: if `commands/` exists with `.md` files, use `AskUserQuestion` tool to ask about migrating to skills structure
6. Run validation: `python3 ${CLAUDE_PLUGIN_ROOT}/scripts/validate-plugin.py "$TARGET"`
   - Options: `--check=structure,manifest,frontmatter,tools,tokens`
   - JSON output: `--json`
   - Verbose: `-v, --verbose`
7. Compile issues by severity (Critical, Warning, Info)

## Phase 2: Agent-Based Optimization

**Goal**: Launch agent to apply ALL fixes. Orchestrator does NOT make fixes directly.

**Condition**: Always execute.

**Actions**:
1. Launch `plugin-optimizer:plugin-optimizer` agent with the following prompt content:
   - Target plugin path (absolute path from Phase 1)
   - Validation console output (issues list from Phase 1)
   - Template validation results
   - User decisions (migration choice if applicable)
   - INSTRUCTION: Analyze the validation output to identify issues
2. Agent autonomously applies fixes (MUST use `AskUserQuestion` tool before applying template fixes, presenting violations with specific examples and before/after comparison)
3. Agent increments version in `.claude-plugin/plugin.json` after fixes:
   - Patch (x.y.Z+1): Bug fixes
   - Minor (x.Y+1.0): New components
   - Major (X+1.0.0): Breaking changes
4. Wait for agent to complete

**Path Reference Rules**:
- Same directory: Use relative paths (`./reference.md`)
- Outside directory: Use `${CLAUDE_PLUGIN_ROOT}` paths
- Component templates: See `${CLAUDE_PLUGIN_ROOT}/examples/`

**Redundancy & Efficiency**:
- Redundancy: Allow strategic repetition of critical content (MUST/SHOULD requirements). Favor concise restatement.
- Efficiency: Agent detects if tasks need Agent Teams (Parallelizable > 5 files, Multi-domain).

## Phase 3: Verification & Deliverables

**Goal**: Verify fixes, generate report, and update documentation.

**Actions**:
1. Execute validation script: `python3 ${CLAUDE_PLUGIN_ROOT}/scripts/validate-plugin.py "$TARGET"`
2. Analyze results: compare with Phase 1 findings, confirm critical issues resolved
3. If critical issues remain, resume agent execution
4. Generate final validation report using template below
5. Update `README.md` to reflect current state (metadata, directory structure, usage instructions; do not append version history log)

## Validation Report Template

```markdown
## Plugin Validation Report

### Plugin: [name]
Location: [absolute-path]
Version: [old] -> [new]

### Summary
[2-3 sentences with key statistics]

### Phase 1: Issues Detected
#### Critical ([count])
- `file/path` - [Issue description]

#### Warnings ([count])
- `file/path` - [Issue description]

### Phase 2: Fixes Applied
#### Structure Fixes
- [Fix description]

#### Template Conformance
- **Agents**: [Count] validated, [count] fixed
- **Instruction-type Skills**: [Count] validated, [count] fixed
- **Knowledge-type Skills**: [Count] validated, [count] fixed

#### Redundancy Fixes
- [Consolidations applied]

### Phase 3: Verification Results
- Structure validation: [PASS/FAIL]
- Manifest validation: [PASS/FAIL]
- Component validation: [PASS/FAIL]
- Tool patterns validation: [PASS/FAIL]
- Token budgets validation: [PASS/FAIL]

### Token Budget Analysis
- Skills analyzed: [count]
- Tier 1 (Metadata ~100): [OK count], [WARNING count]
- Tier 2 (SKILL.md under 5k): [OK count], [WARNING count], [CRITICAL count]
- Tier 3 (References, effectively unlimited): [total tokens]

### Component Inventory
- Commands: [count] found, [count] valid
- Agents: [count] found, [count] valid
- Skills: [count] found, [count] valid

### Remaining Issues
[Issues that couldn't be auto-fixed with explanations]

### Overall Assessment
[PASS/FAIL] - [Detailed reasoning]
```

© FradSer · MIT · FradSer/dotclaude

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
printing-press-polish mvanhorn Скилл printing-press-polish для Claude Code запускает проверки сгенерированных CLI, устраняет ошибки тестов и готовит утилиту к публикации. Запускается при verify ниже 80% или scorecard меньше 85. CX Codex +1 7 200установок caveman-optimize JuliusBrussee Скилл caveman-optimize помогает разобрать наблюдение Caveman, выбрать кандидата оператором и проверить его парным сравнением с базовой версией. Изменения требуют явного одобрения. CX Codex +1 129 900установок no-comments backnotprop Скилл no-comments для Claude Code запускает субагента для чистки лишних комментариев и превращает ограничения в коде в тесты или проверки линтера. CX Codex +1 10 400установок pr-review MiniMax-AI Скилл pr-review для Claude Code проверяет пуллреквесты в репозиториях скиллов в два этапа: валидирует структуру и аудирует содержание. CX Codex +1 1 800установок architecture coco-research Слэш-команда architecture фиксирует, что в прогоне /team считается соответствием архитектуре, и требует под каждое такое утверждение запуск валидатора с кодом выхода. CX Codex +1 ★ 328звёзд репо Phlow MCP Server qompassai Phlow MCP Server — MCP-сервер для Claude Code, который разделяет агентную разработку между планировщиком, кодером и ревьюером и проверяет тесты и линтеры перед сохранением правок. CX Codex +1

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

Весь набор →
writing-plans Скилл writing-plans для Claude Code, Codex, Cursor и других платформ превращает готовый дизайн в пошаговый план реализации. CX Codex +1 123установок refactor-project Скилл refactor-project для Claude Code, Codex, Cursor и других агентов запускает автоматический рефакторинг сразу по всем файлам проекта. Находит дубли, выравнивает стиль и убирает устаревший код за один прогон. CX Codex +1 122установок plugin-best-practices Скилл plugin-best-practices для проверки структуры, манифестов и архитектуры Claude Code плагинов по стандартам фреймворка. Помогает убедиться, что плагин соответствует требованиям до отправки в маркетплейс. CX Codex +1 121установок commit Скилл commit для Claude Code создаёт атомарные conventional-коммиты через git-agent. Оформляет изменения по краткому намерению. CX Codex +1 121установок create-prd Скилл create-prd помогает собрать идею продукта в PRD: задаёт вопросы, выбирает формат и сохраняет готовый документ в Markdown или Feishu. CX Codex +1 117установок create-issues Скилл create-issues автоматизирует создание GitHub issues с соблюдением принципов TDD, правильной разметкой и auto-closing ключевыми словами. Помогает документировать баги, требования и PR-scoped задачи по единым стандартам. CX Codex +1 116установок best-practices Скилл best-practices задаёт правила качества кода и шаблоны под TypeScript, Python, Go, Swift и React. CX Codex +1 115установок refactor Скилл refactor запускает автоматический рефакторинг выбранных файлов, папок или недавних правок через агента упрощения кода. CX Codex +1 113установок

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

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