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

plugin-validator — скилл для Claude Code: проверка плагинов

Скилл plugin-validator проверяет структуру плагинов перед релизом и находит скрытые ошибки в хуках — команды без обработки исключений, которые молча падают. Нужен перед публикацией в маркетплейс.

MIT 122 установок ★ 3 обновлён 2026-10-25

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

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

plugin-validator запускает трёхфазную проверку: сначала контролирует структуру директории и синтаксис plugin.json, потом ищет в хуках bash и Python команды без обработки ошибок (mkdir, cp, rm без if !, except без вывода в stderr), в конце предлагает шаблоны фиксов. Скрипт использует Bash, jq, Grep и работает через uv run.

Валидатор различает точки входа хуков (должны всегда выдавать ошибку в stderr) и утилиты (могут молча проваливаться). Выходные коды: 0 — всё в порядке, 1 — нарушения, 2 — ошибка пути или структуры. После проверки скилл обновляет сам себя — если инструкция устарела или сломалась, исправления уходят сразу в файл, не откладываются.

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

  • найти скрытые ошибки в хуках до загрузки в маркетплейс
  • проверить синтаксис plugin.json и наличие обязательных полей
  • аудировать bash-команды на пропущенную обработку исключений
  • выявить except:pass в Python без вывода в stderr
  • получить конкретные примеры, как переписать проблемный код

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

  • Проверь структуру плагина в plugins/my-plugin/
  • Запусти аудит скрытых ошибок в plugins/my-plugin/ и покажи фиксы
  • Валидируй плагин перед регистрацией в маркетплейс

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

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill plugin-validator -a claude-code

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

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

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

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

Вопросы о plugin-validator

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

Выполни npx skills add terrylica/cc-skills --skill plugin-validator -a claude-code, потом открой ~/.claude/skills/plugin-validator/SKILL.md для проверки.

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

Проверяет, что в plugin.json есть обязательные поля, хуки обрабатывают ошибки (mkdir, cp, rm имеют if !, except имеют вывод в stderr), и выдаёт примеры, как это переписать.

В чём разница между хуками и скриптами для валидатора?

Хуки (plugins/*/hooks/) должны всегда сообщать об ошибке в stderr; скрипты (plugins/*/scripts/) могут падать молча. Это разные требования.

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

SKILL.md · MIT
---
name: plugin-validator
description: Validate plugin structure and silent failures. TRIGGERS - plugin validation, check plugin, hook audit.
allowed-tools: Read, Bash, Glob, Grep, TodoWrite
---

# Plugin Validator

Comprehensive validation for Claude Code marketplace plugins.

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## When to Use This Skill

Use this skill when:

- Validating plugin structure before release
- Auditing hooks for silent failures
- Checking plugin.json syntax and required fields
- Verifying skill file formatting and frontmatter

## Quick Start

```bash
# Validate a specific plugin
uv run plugins/plugin-dev/skills/plugin-validator/scripts/audit_silent_failures.py plugins/my-plugin/

# Validate with fix suggestions
uv run plugins/plugin-dev/skills/plugin-validator/scripts/audit_silent_failures.py plugins/my-plugin/ --fix
```

## Validation Phases

### Phase 1: Structure Validation

Check plugin directory structure:

```bash
/usr/bin/env bash << 'VALIDATE_EOF'
PLUGIN_PATH="${1:-.}"

# Check plugin.json exists
if [[ ! -f "$PLUGIN_PATH/plugin.json" ]]; then
    echo "ERROR: Missing plugin.json" >&2
    exit 1
fi

# Validate JSON syntax
if ! jq empty "$PLUGIN_PATH/plugin.json" 2>/dev/null; then
    echo "ERROR: Invalid JSON in plugin.json" >&2
    exit 1
fi

# Check required fields
REQUIRED_FIELDS=("name" "version" "description")
for field in "${REQUIRED_FIELDS[@]}"; do
    if ! jq -e ".$field" "$PLUGIN_PATH/plugin.json" >/dev/null 2>&1; then
        echo "ERROR: Missing required field: $field" >&2
        exit 1
    fi
done

echo "Structure validation passed"
VALIDATE_EOF
```

### Phase 2: Silent Failure Audit

**Critical Rule**: All hook entry points MUST emit to stderr on failure.

Run the audit script:

```bash
uv run plugins/plugin-dev/skills/plugin-validator/scripts/audit_silent_failures.py plugins/my-plugin/
```

#### What Gets Checked

| Check         | Target Files | Pattern                                |
| ------------- | ------------ | -------------------------------------- |
| Shellcheck    | `hooks/*.sh` | SC2155, SC2086, etc.                   |
| Silent bash   | `hooks/*.sh` | `mkdir\|cp\|mv\|rm\|jq` without `if !` |
| Silent Python | `hooks/*.py` | `except.*: pass` without stderr        |

#### Hook Entry Points vs Utility Scripts

| Location                 | Type        | Requirement          |
| ------------------------ | ----------- | -------------------- |
| `plugins/*/hooks/*.sh`   | Entry point | MUST emit to stderr  |
| `plugins/*/hooks/*.py`   | Entry point | MUST emit to stderr  |
| `plugins/*/scripts/*.sh` | Utility     | Fallback behavior OK |
| `plugins/*/scripts/*.py` | Utility     | Fallback behavior OK |

### Phase 3: Fix Patterns

#### Bash: Silent mkdir

```bash
# BAD - silent failure
mkdir -p "$DIR"

# GOOD - emits to stderr
if ! mkdir -p "$DIR" 2>&1; then
    echo "[plugin] Failed to create directory: $DIR" >&2
fi
```

#### Python: Silent except pass

```python
# BAD - silent failure
except (json.JSONDecodeError, OSError):
    pass

# GOOD - emits to stderr
except (json.JSONDecodeError, OSError) as e:
    print(f"[plugin] Warning: {e}", file=sys.stderr)
```

## Integration with /plugin-dev:create

This skill is invoked in Phase 3 of the plugin-add workflow:

```markdown
### 3.4 Plugin Validation

**MANDATORY**: Run plugin-validator before registration.

Task with subagent_type="plugin-dev:plugin-validator"
prompt: "Validate the plugin at plugins/$PLUGIN_NAME/"
```

## Exit Codes

| Code | Meaning                             |
| ---- | ----------------------------------- |
| 0    | All validations passed              |
| 1    | Violations found (see output)       |
| 2    | Error (invalid path, missing files) |

## References

- [Silent Failure Patterns](./references/silent-failure-patterns.md)


## Troubleshooting

| Issue                        | Cause                         | Solution                                            |
| ---------------------------- | ----------------------------- | --------------------------------------------------- |
| plugin.json not found        | Missing manifest file         | Create plugin.json with required fields             |
| Invalid JSON syntax          | Malformed plugin.json         | Run `jq empty plugin.json` to find syntax errors    |
| Missing required field       | Incomplete manifest           | Add name, version, description to plugin.json       |
| Shellcheck errors            | Bash script issues            | Run `shellcheck hooks/*.sh` to see details          |
| Silent failure in bash       | Missing error handling        | Add `if !` check around mkdir/cp/mv/rm commands     |
| Silent except:pass in Python | Missing stderr output         | Add `print(..., file=sys.stderr)` before pass       |
| Exit code 2                  | Invalid path or missing files | Verify plugin path exists and has correct structure |
| Violations after --fix       | Fix suggestions not applied   | Manually apply suggested fixes from output          |

## Post-Execution Reflection

After this skill completes, reflect before closing the task:

0. **Locate yourself.** — Find this SKILL.md's canonical path (Glob for this skill's name) before editing. All corrections target THIS file and its sibling references/ — never other documentation.
1. **What failed?** — Fix the instruction that caused it. If it could recur, add it as an anti-pattern.
2. **What worked better than expected?** — Promote it to recommended practice. Document why.
3. **What drifted?** — Any script, reference, or external dependency that no longer matches reality gets fixed now.
4. **Log it.** — Every change gets an evolution-log entry with trigger, fix, and evidence.

Do NOT defer. The next invocation inherits whatever you leave behind.

---
---

© terrylica · MIT · terrylica/cc-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
bash-script-validator akin-ozer Скилл bash-script-validator для Claude Code проверяет Bash- и POSIX-скрипты на синтаксические ошибки, проблемы ShellCheck и риски безопасности. Запускается по просьбе проверить, исправить или сделать shell-скрипт переносимым. CX Codex +1 775установок jenkinsfile-validator akin-ozer Скилл jenkinsfile-validator для Claude Code локально проверяет синтаксис Jenkinsfile, ищет открытые секреты и тестирует общие библиотеки на Groovy. Проверяет пайплайны до отправки коммита в репозиторий. CX Codex +1 739установок simulation-validator HeshamFS Скилл simulation-validator для Claude Code проверяет численные симуляции до, во время и после запуска. Разбирает сбои. CX Codex +1 ★ 95звёзд репо python-error-handling Seth Hobson Скилл python-error-handling для Claude Code помогает проектировать проверку входных данных и обработку исключений в Python. Срабатывает при работе с API, пакетными задачами и стратегиями ошибок. CX Codex +1 14 116установок pbip-validator Kurt Buhler Субагент pbip-validator диагностирует структурные ошибки, нарушения схемы JSON и синтаксис TMDL в Power BI проектах. Запускается, когда нужно проверить целостность PBIP перед открытием в Desktop или после переименований таблиц. CX Codex +1 ★ 1 104звёзд репо skill-validator-agent qdhenry Субагент skill-validator-agent проверяет структуру и содержимое скиллов Claude Code: от YAML в SKILL.md до запуска скриптов. Пригодится перед выпуском нового скилла или после правок. CX Codex ★ 1 357звёзд репо

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

Весь набор →
ml-failfast-validation Скилл ml-failfast-validation для Claude Code запускает быстрые проверки ML-экспериментов перед долгим обучением на GPU и выявляет ошибки данных и градиентов. CX Codex +1 124установок pr-gfm-validator Скилл pr-gfm-validator переписывает относительные ссылки в описании пул-реквеста в абсолютные blob-URL с вашей ветки, чтобы ревьюеры не упирались в 404. CX Codex +1 123установок pypi-doppler Скилл pypi-doppler для Claude Code и пяти других платформ: публикует Python-пакет в PyPI с токеном из Doppler — только с локальной машины. CI/CD намеренно заблокирован: скрипт проверяет окружение и останавливается при обнаружении пайплайна. CX Codex +1 123установок schema-e2e-validation Скилл schema-e2e-validation запускает генерацию и E2E-проверку YAML-схемы через Earthly. Пригодится перед коммитом или для сверки схемы с ClickHouse Cloud. CX Codex +1 123установок evolutionary-metric-ranking Скилл evolutionary-metric-ranking находит лучшие конфигурации моделей и стратегий через процентильные пороги, пересечение метрик и эволюционный поиск. CX Codex +1 121установок pre-ship-review Скилл pre-ship-review проводит структурированную проверку качества кода перед PR, релизом или вехой. Находит ошибки на границах компонентов, где должны совпадать контракты, примеры и тесты. CX Codex +1 120установок pueue-job-orchestration Скилл pueue-job-orchestration управляет длинными задачами и пакетами команд через очередь pueue с контролем параллелизма и сохранением логов. CX Codex +1 120установок distributed-job-safety Скилл distributed-job-safety для Claude Code находит гонки и сбои в параллельных пайплайнах на pueue, moon и systemd-run. Выявляет риски при одновременной записи файлов и работе с общими ресурсами. CX Codex +1 120установок

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

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