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

verify · sethgammon — скилл для Claude Code и Codex: тест хуков прямо в сессии

Скилл verify для Claude Code и Codex, самопроверяет конвейер хуков Citadel во время работы. Запускает реальные вызовы инструментов (Write, Edit, Bash, Read), проверяет, что все хуки срабатывают, телеметрия накапливается и нет ошибок.

MIT ★ 937 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local
Открыть на GitHub

Что делает verify

Скилл выполняет последовательность операций: пишет временный файл, редактирует его, запускает Bash-команду, читает файл обратно и удаляет его. На каждом шаге срабатывают разные хуки — PreToolUse (защита файлов, governance) и PostToolUse (логирование).

После теста скилл сравнивает исходное состояние телеметрии с новым: проверяет, выросли ли счётчики в hook-timing.jsonl, audit.jsonl и остаются ли ошибки на нуле. Выводит результат как «HOOK HEALTH: PASS» или «HOOK HEALTH: FAIL» с построчным разбором каждой проверки.

Нужен для диагностики после обновления хуков или если работа инструментов кажется нестабильной. Если директория .planning/telemetry/ не создана, скилл отказывается с сообщением об инициализации проекта.

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

  • проверить, что все хуки в конвейере срабатывают без ошибок
  • диагностировать, почему инструменты работают нестабильно или слишком медленно
  • убедиться, что телеметрия накапливается и логируется правильно
  • валидировать настройку Citadel после установки в новый проект

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

  • Проверь здоровье хуков: /verify
  • Запусти самотест конвейера: verify hooks
  • Проверь, что хуки не сломались: verify или check hooks

Как установить verify

1Через маркетплейс плагинов

/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local

Команда ставит плагин citadel целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add SethGammon/Citadel --skill verify -a claude-code

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

~/.claude/skills/verify/SKILL.md

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

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

Вопросы о verify

Как установить verify в Claude Code?

Выполни команды по порядку: /plugin marketplace add SethGammon/Citadel, затем /plugin install citadel@citadel-local, потом npx skills add SethGammon/Citadel --skill verify -a claude-code и открой ~/.claude/skills/verify/SKILL.md.

Как установить verify в Codex?

Запусти npx skills add SethGammon/Citadel --skill verify -a codex и открой .agents/skills/verify/SKILL.md.

Что означает HOOK HEALTH: FAIL и как это исправить?

Скилл нашёл, что один или больше хуков не срабатывают. Посмотри вывод с конкретной ошибкой — там покажут, какой хук не сработал. Попробуй запустить node scripts/verify-hooks.js для более глубокой диагностики или проверь, что .planning/telemetry/ существует.

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

SKILL.md · MIT
---
name: verify
license: MIT
description: >-
  Self-test the Citadel hook pipeline from within a live session. Exercises
  real tool calls (Write, Edit, Bash, Read) and checks that hooks fired,
  telemetry accumulated, and no errors occurred. Reports HOOK HEALTH: PASS
  or HOOK HEALTH: FAIL with a per-hook breakdown.
user-invocable: true
auto-trigger: false
trigger_keywords:
  - verify
  - verify hooks
  - hook health
  - self-test
  - check hooks
  - harness health
last-updated: 2026-03-27
---

# /verify — Hook Pipeline Self-Test

Use this when:
- Hooks were recently updated and you want a live sanity check
- Something feels wrong (tools seem too slow, quality-gate not firing)
- After installing Citadel in a new project

## Protocol

### Step 1: Baseline

Read the current telemetry state:
```
.planning/telemetry/hook-timing.jsonl  → count lines (baseline_timing)
.planning/telemetry/audit.jsonl        → count lines (baseline_audit)
.planning/telemetry/hook-errors.log    → size in bytes (baseline_errors)
```

If telemetry directory doesn't exist, note it (init-project may not have run).

### Step 2: Exercise hooks

Run these tool calls in sequence. Each exercises a different hook:

1. **Write** a temp file at `.planning/verify-temp.ts`:
   ```typescript
   // citadel verify probe
   export const verifyProbe = true;
   ```
   → Exercises: PreToolUse (protect-files, governance), PostToolUse (post-edit)

2. **Edit** the same file — change `true` to `false`:
   → Exercises: PreToolUse (protect-files, governance), PostToolUse (post-edit)

3. **Bash** a harmless read command: `echo "verify-probe"`
   → Exercises: PreToolUse (governance)

4. **Read** the temp file back
   → Exercises: PreToolUse (protect-files — should allow, it's not .env)

5. **Delete** the temp file: `rm .planning/verify-temp.ts` or equivalent
   → Cleanup

### Step 3: Check side effects

After all tool calls complete, read telemetry again:

| Check | Expected | Result |
|---|---|---|
| hook-timing.jsonl grew | +2 or more lines (Write + Edit post-hooks) | PASS/FAIL |
| audit.jsonl grew | +3 or more lines (Write + Edit + Bash pre-hooks) | PASS/FAIL |
| hook-errors.log unchanged | same size as baseline | PASS/FAIL |

### Step 4: Report

Output a results block:

```
=== HOOK HEALTH CHECK ===

hook-timing.jsonl:  +N lines  [PASS / FAIL]
audit.jsonl:        +N lines  [PASS / FAIL]
hook-errors.log:    no errors [PASS / FAIL — N new errors]

HOOK HEALTH: PASS
```

Or if any check fails:

```
HOOK HEALTH: FAIL

Failing checks:
- hook-timing.jsonl did not grow: PostToolUse hooks may not be firing
  → Verify hooks are installed: node scripts/verify-hooks.js
  → Check settings.json: cat .claude/settings.json | grep PostToolUse

- audit.jsonl did not grow: governance hook may not be firing
  → Check: node hooks_src/governance.js <<< '{}'
```

## Edge Cases

**No .planning/telemetry/ directory**: Init-project may not have run.
Output: "HOOK HEALTH: FAIL — .planning/telemetry/ not found. Run: node hooks_src/init-project.js"

**Hooks installed but telemetry still zero**: The project may have a harness.json
that disables telemetry. Check `features.telemetry` in `.claude/harness.json`, Citadel's shared config path for all runtimes including Codex.

**First-time run (no baseline)**: If the files don't exist before the test,
they should be created during the test. Treat "file created" as equivalent to "grew".

## What This Does NOT Test

- Hook correctness on edge cases (use verify-hooks.js for that)
- Full PreToolUse → tool → PostToolUse sequence isolation (use integration-test.js)
- Skill output quality (use skill-bench.js --execute)

## Quality Gates

- All 3 telemetry checks must pass: timing grew, audit grew, no new errors
- Temp file must be cleaned up regardless of pass/fail outcome
- Report must include exact counts (+N lines), not just PASS/FAIL
- If .planning/telemetry/ does not exist, FAIL immediately — do not fabricate counts

## Contextual Gates

**Disclosure:** Creates and deletes `.planning/verify-temp.ts` during the test. No other files modified.
**Reversibility:** green — temp file deleted on completion; no persistent changes.
**Trust gates:** Any — no restrictions.

## Exit Protocol

```
---HANDOFF---
- Hook pipeline: PASS / FAIL
- hook-timing.jsonl: +N lines
- audit.jsonl: +N lines
- hook-errors.log: N new errors (0 expected)
- Reversibility: green — no persistent changes; verify-temp.ts cleaned up
- Next: if FAIL, run node scripts/verify-hooks.js for deeper diagnostics
---
```

© SethGammon · MIT · SethGammon/Citadel

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — verify от других авторов.

verify react Скилл verify проверяет код перед коммитом в репозиторий React. Запускает форматирование, линтер, проверку типов Flow и тесты. CX Codex +1 1 200установок verify Yeachan-Heo Скилл verify превращает «должно работать» в проверяемые доказательства: что запускали, что прошло, что осталось непроверенным. CX Codex +1 721установок verify официальный anthropics Скилл verify для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который тестирует изменения в harness end-to-end без Docker. CX Codex +1 257установок verify codewithmukesh Скилл verify для Claude Code, Codex, Cursor и других агентов запускает семифазный конвейер проверки .NET-проекта: сборка, анализаторы, антипаттерны, тесты, безопасность, форматирование, ревью диффа. CX Codex +1 4 000установок verify plastic-labs Скилл verify для Claude Code проверяет изменения Honcho на работающем приложении. Он запускает локальный стек и проверяет HTTP API, очередь deriver и планы SQL-запросов. CX Codex +1 172установок openspec-verify-change openspec Скилл openspec-verify-change сверяет написанный код со спецификациями, задачами и архитектурой OpenSpec перед архивацией изменения. Пригодится при финальной приёмке задач. CX Codex +1 4 000установок verify-this cursor Скилл verify-this проверяет конкретное утверждение на локальных данных: снимает замеры до и после, сравнивает артефакты и выдаёт один вердикт. CX Codex +1 2 600установок audit-verify-explain-grade-5 MengTo Скилл audit-verify-explain-grade-5 для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI, который проверяет изменения с опорой на реальные доказательства и объясняет результат простым языком. CX Codex +1 1 700установок gsd-verify-work open-gsd Скилл gsd-verify-work для Claude Code проводит приёмочное тестирование созданных функций в диалоге с пользователем. Запускает проверку по шагам и сохраняет отчёт в файл UAT. CX Codex +1 594установок verify-and-stop JuliusBrussee Скилл verify-and-stop подтверждает выполнение условий сдачи без раздувания правок. Помогает при финальной проверке тикета и точечном прогоне проверок. CX Codex +1 129 000установок convex-verify convex Скилл convex-verify для Claude Code проверяет функции Convex на реальных сценариях с несколькими пользователями. Он запускается по просьбе проверить конкретный запрос, мутацию или действие. CX Codex +1 43 800установок

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

Весь набор →
arch-reviewer Субагент arch-reviewer проверяет архитектурные границы слоёв, циклические импорты и правила проекта без изменения файлов. CX Codex ★ 937звёзд репо knowledge-extractor Субагент knowledge-extractor извлекает из завершённой работы повторно используемые решения и ошибки и сохраняет их для вики. Запускайте его после крупного этапа разработки. CX Codex ★ 937звёзд репо session-handoff Скилл session-handoff собирает итоги текущей сессии в блок HANDOFF, чтобы следующая сессия сразу продолжила работу без повторного аудита. CX Codex +1 ★ 937звёзд репо unharness Скилл unharness для Claude Code готовит план удаления Citadel из проекта и сохраняет переносимый архив. Запускается по просьбе удалить Citadel или очистить проект от harness. CX Codex +1 ★ 937звёзд репо grill Скилл grill превращает размытый план в чёткое техническое задание через интервью: по одному вопросу, каждый с готовым ответом на выбор. CX Codex +1 ★ 937звёзд репо autopilot Скилл autopilot автоматизирует очередь задач из папки .planning/intake/: составляет бриф, вносит правки в код и проверяет результат. CX Codex +1 ★ 937звёзд репо doc-gen Скилл doc-gen создаёт комментарии к функциям, README для каталогов и справку по API, подстраиваясь под стиль проекта. Полезен, когда документацию нужно сверить с кодом, а не пересказать сигнатуры. CX Codex +1 ★ 937звёзд репо policy-enforcer Субагент policy-enforcer для Claude Code сверяет планируемое действие с правилами Citadel и возвращает вердикт: разрешить или заблокировать. Archon и Fleet запускают его перед операциями с низкой обратимостью. CX Codex ★ 937звёзд репо

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

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