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

app-verification — скилл для Claude Code

Скилл app-verification для Claude Code, Codex, Cursor и других агентов: создаёт и поддерживает в репозитории собственный харнесс верификации — команды verify, doctor и seed.

MIT 217 установок ★ 216 обновлён 2026-11-10

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

Что делает app-verification

Скилл живёт не в репозитории скилла, а в целевом проекте: после установки создаёт папку со скриптами верификации — и любой агент, открывающий этот репозиторий, запускает приложение одинаково, а не пишет скрипт с нуля каждую сессию.

Есть два режима. Create-режим применяется, когда в репозитории ещё нет verify, doctor и seed: скилл опрашивает репо, создаёт три команды по жёсткому контракту и доказывает харнесс «вживую» на трёх-пяти фичах из feature map. Maintain-режим ведёт уже существующий харнесс: каждую сессию запускает doctor первым, получает один из трёх исходов (clean, changed или blocked) и, если найден реальный баг продукта, формирует reproduce-first handoff — первая строка которого всегда Reproduced, Reproduced but already fixed on main или Could not reproduce.

Create-режиму нужен shell и родной тулчейн целевого репозитория. Верификация native и desktop-путей требует computer-use — и только как метод последнего выбора, не первого. Команда seed отказывается работать с нелокальной базой или основным инстансом, а не подменяет данные молча.

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

  • создать verify-CLI, doctor и seed в репозитории с нуля
  • изолировать каждый воркдерев на свой порт и базу данных
  • доказать, что каждая фича из feature map работает или явно пропущена с причиной
  • воспроизвести баг-репорт и сформировать reproduce-first handoff
  • обнаружить drift харнесса и зафиксировать его отдельным коммитом

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

  • Построй харнесс верификации для этого репозитория
  • Добавь команду doctor и изолируй инстанс на отдельный порт
  • Докажи, что все фичи из feature map всё ещё работают

Как установить app-verification

1Через Skills CLI (Vercel)

npx skills add mblode/agent-skills --skill app-verification -a claude-code

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

~/.claude/skills/app-verification/SKILL.md

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

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

Вопросы об app-verification

Как установить app-verification в Claude Code?

Выполните npx skills add mblode/agent-skills --skill app-verification -a claude-code. Скилл появится по пути ~/.claude/skills/app-verification/SKILL.md.

Что делает скилл app-verification?

Создаёт и поддерживает в целевом репозитории харнесс верификации: команды verify, doctor и seed, feature map с точки зрения пользователя, изоляцию по воркдереву и reproduce-first формат для баг-репортов.

Чем app-verification отличается от ui-verification?

ui-verification делает специализированные браузерные проверки по фиксированному каталогу UI-правил. app-verification строит общий харнесс всего приложения и может вызывать ui-verification как один из шагов внутри verify.

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

SKILL.md · MIT
---
name: app-verification
description: Builds and maintains a repo's own verification harness (verify CLI, doctor, worktree isolation, feature map, seed data) and a reproduce-first bug handoff. Use when asked to "build a verification harness", "add a doctor command", "prove every feature still works", or "reproduce this bug report".
compatibility: Create mode needs a shell and the target repo's own toolchain (whatever starts, seeds, and drives that app). Native and desktop proof paths need a computer-use tool as the last-resort method. Runs only when called by name; see Invocation below.
---

# App Verification

Builds, inside a product's own repository, the harness every agent uses to run that product and prove a claim about it: a verify CLI, a doctor command, an isolated instance per worktree, a feature map written from the user's point of view, seed data and test accounts, and a reproduce-first bug handoff. The harness lives in the target repo, not in this skill; this skill scaffolds and then maintains it, so every agent that opens that repo runs the app the same way instead of writing a throwaway script each session.

- **IS:** scaffolding a project-local verification harness (Create mode) and running or extending one that already exists (Maintain mode): the verify CLI's contract, the feature-map format, the proof record, per-worktree isolation and seed data, the cheapest-method ladder up to computer use, and the bug-handoff format.
- **IS NOT:** ad hoc browser probes against a fixed catalogue of UI rules (`ui-verification`; this skill's `verify` can call those probes as one check among several), repo-wide module boundaries and enforcement tooling (`codebase-architecture`; this skill's CI wiring follows its enforcement order), pruning an existing test suite (`test-audit`), or a plan for one feature (`planning`).

## Invocation

Create mode edits the target repo and Maintain mode drives a real running instance of it; both run only when named, not from a loose "check the app" prompt a lighter skill might serve better. On a host that supports it, add `disable-model-invocation: true` to the installed copy's frontmatter. It is a host extension, not a portable field, so it is not shipped in this source (`agent-skills-creator`'s `references/format-specification.md` explains why). Hosts with an equivalent explicit-invocation setting should apply it the same way.

## Contents

- [Modes](#modes)
- [The harness contract](#the-harness-contract)
- [Create mode](#create-mode)
- [Maintain mode](#maintain-mode)
- [References](#references)
- [Gotchas](#gotchas)
- [Related skills](#related-skills)
- [Credit](#credit)

## Modes

Pick by what exists, and say which you picked.

| Mode | You are here when | Output |
|---|---|---|
| **Create** | The repo has no verify CLI, doctor command, or feature map yet | A working harness, proven once end to end against a real feature, handed off to Maintain mode |
| **Maintain** | A harness already exists and needs to run this session, gain a feature, or investigate a bug report | A `clean` / `changed` / `blocked` outcome, or a reproduce-first bug handoff |

Copy this to track progress:

```text
App verification progress:
- [ ] Mode chosen and stated (Create / Maintain)
- [ ] doctor run first, read-only, before any drive
- [ ] Isolation confirmed: own port, own database, own browser profile; refused (not fell back to) the main instance
- [ ] Every path in scope checked or named as a skip with a reason
- [ ] Native/desktop paths, if any, verified with computer use as the last-resort method, not the first
- [ ] Outcome stated: clean / changed / blocked, or a reproduce-first handoff
```

## The harness contract

Both modes build toward the same three commands, kept inside a skill folder in the target repo (for example `.claude/skills/verify-<app>/` or that host's equivalent project-skill location) so the commands live at one path every session finds the same way.

| Command | Does | Must |
|---|---|---|
| `doctor` | One read-only pass answering "is this instance worth driving": toolchain, isolation, ports, database, migrations, seed, build freshness, and whichever driver (browser, computer-use) the harness needs | Changes nothing. Exits non-zero on any failure, each failure line naming the exact fix. Prints `blocked by <id>` for a check whose dependency already failed instead of a cascade of unrelated-looking failures. Offers `--json` for a caller that branches on the result |
| `seed` | Loads fixed test accounts and demo data | Idempotent: safe to run twice, safe against a database that already has the seed. Refuses a non-local or main-instance database rather than seeding it |
| `verify` | Runs the checks the feature map lists for the change, cheapest method first, and writes a proof record of what ran, what it covered, what it skipped, and why | Every path a feature lists gets a check or a named skip. Exits non-zero on a failed check or a changed source file no feature owns |

`doctor` and `verify` are separate commands: one is read-only triage, the other drives and reports. Merging them hides the read-only fast check behind the slow one every time.

## Create mode

`references/create-mode.md`. Interview the repo (surface, run, drive, observe, isolate), scaffold `doctor`, `seed`, `verify` and the feature map per the contract above, wire isolation before writing the first feature file, seed the top three to five features, then prove the generated harness end to end before calling it done. A harness nobody has run is a draft, not a deliverable.

## Maintain mode

`references/maintain-mode.md`. Run `doctor` first, every session, before the first drive and after any failed one. Pick one outcome and say which: `clean` (nothing needed changing), `changed` (one PR or commit of proven corrections to the harness itself, never to product code), or `blocked` (name exactly what blocked it). A maintenance run that finds a real product bug reports it; it does not quietly patch around it inside the harness.

Two things this mode owns that a lighter probe skill does not: **scoped proof** (every listed path checked or skipped with a reason, recorded in the proof file; `references/maintain-mode.md`) and the **reproduce-first bug handoff**, whose first line is exactly `Reproduced`, `Reproduced but already fixed on main` or `Could not reproduce` (`references/bug-handoff.md`).

## References

Load only when the condition applies.

| Reference | Mode | Read when |
|---|---|---|
| [references/create-mode.md](references/create-mode.md) | Create | Bootstrapping a harness where none exists, or reshaping `doctor` or `verify` |
| [references/maintain-mode.md](references/maintain-mode.md) | Maintain | Running or extending an existing harness, reading or writing the proof record, or auditing the harness for drift |
| [references/feature-map-format.md](references/feature-map-format.md) | Both | Writing or reading a feature file, renaming a feature id, or building the map's completeness check |
| [references/verification-ladder.md](references/verification-ladder.md) | Both | Choosing a method for a path, marking a path `manual`, or deciding whether a native/desktop path needs computer use |
| [references/worktree-isolation.md](references/worktree-isolation.md) | Both | Setting up or checking port, database, env-file, and browser-profile isolation, or seeding test accounts and a sign-in shortcut |
| [references/reusable-checks.md](references/reusable-checks.md) | Both | Adding repeatable API requests, scenario assertions, checked cleanup, or capture adapters |
| [references/bug-handoff.md](references/bug-handoff.md) | Maintain | Investigating a bug report |

## Gotchas

- A dev-only sign-in shortcut or a fixed test-account secret is a production backdoor the moment it ships enabled; gate it and verify the guard per `references/worktree-isolation.md` before adding one.
- `verify --fast` (cli checks only) is a development convenience, never a merge gate on its own; a run that skipped every browser and computer-use check is not the same proof as a full one, and the proof record says which mode ran.
- Two feature maps drift the moment a second one exists. Keep one canonical map per app; if a lighter probe skill also tracks routes or components, point at this map rather than growing a parallel one.

## Related skills

- `ui-verification`: scoped browser probes against a fixed UI rule catalogue, one finding at a time. This skill's `verify` can call those probes for the paths they cover; it does not replace them for a rule-by-rule audit.
- `codebase-architecture`: repo-wide module boundaries, CI guardrails, and the enforcement order this skill's own CI wiring follows.
- `test-audit`: suite-wide pruning of a durable test suite, a different asset from the feature map here. Gating a new test in a diff is `tidy`.
- `planning`: a plan for one feature; a new feature's plan is where its eventual feature file starts.

Maintenance only: `evals/evals.json` holds the behavioural scenarios for anyone changing this skill. It never loads during a verification run.

## Credit

Builds on Lauren Tan's pstack `create-verification-skill` and `maintain-verification-skill` (MIT): the interview-then-generate method, the outcome-based maintenance loop, and the reproduce-first handoff are hers. This skill generalizes that method past one company's conventions and adds a machine-checkable proof contract. Credit them; this is not a copy of either file.

© mblode · MIT · mblode/agent-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
create-verification-skill backnotprop Скилл create-verification-skill генерирует локальный скилл верификации для репозитория, проверяя работу веб-интерфейса, CLI или сервиса по реальным сценариям пользователя. CX Codex +1 10 400установок cross-platform-cloud-verification dominikmartn Скилл cross-platform-cloud-verification для Claude Code организует облачную проверку кода на разных ОС и архитектурах после завершения локальных тестов. Запускается для анализа кроссплатформенных изменений. CX Codex +1 ★ 720звёзд репо deploy-with-verification Sharrmavishal Субагент deploy-with-verification проводит тесты, сборку и деплой, затем проверяет живую систему и фиксирует подтверждённую ревизию. Подходит для выкладки в production. CX Codex ★ 42 780звёзд репо pipeline-conductor chrono-meta Скилл pipeline-conductor связывает проверки проекта в последовательный прогон и собирает результаты в общий отчёт. Запускайте его, когда нужно пройти несколько этапов проверки по порядку. CX Codex +1 ★ 33звёзд репо verification-gate sentimony Скилл verification-gate не даёт объявить работу законченной без свежих доказательств: собирает матрицу проверок и выносит вердикт по конкретному набору утверждений. CX Codex +1 2 600установок verify официальный anthropics Скилл verify для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который тестирует изменения в harness end-to-end без Docker. CX Codex +1 257установок

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

Весь набор →
eli5 Скилл eli5 для Claude Code подбирает форму объяснения: простой текст, контролируемый английский, диаграмма, HTML-страница или видео. Срабатывает на ответы агента, забитые жаргоном. CX Codex +1 407установок seo Скилл проверяет техническое SEO, помогает исследовать поисковый спрос и измерять видимость в поиске и ИИ-ответах. Подключайте его для аудита, исправления индексации или подготовки брифа. CX Codex +1 391установок save-md Скилл save-md сохраняет веб-страницы, YouTube-видео, Google Docs и PDF в файл .md с метаданными источника. Извлекает полный текст через прямые экспорт-endpoints, минуя пересказы. CX Codex +1 367установок chat-history Скилл chat-history ищет решения, исправления и ход обсуждений в прошлых AI-чатах, связывая найденное с исходными файлами и строками. CX Codex +1 301установок ghostwriter Скилл ghostwriter для Claude Code пишет и редактирует тексты голосом пользователя или компании. Запускается по просьбе составить сообщение, README или критику черновика. CX Codex +1 299установок test-audit Скилл test-audit для Claude Code, Cursor, Codex и других агентов, который вырезает малоценные тесты из сьюта до заданной цели, сохраняя покрытие. Запускается как точечный аудит папки или кампания на весь репозиторий с числовым таргетом. CX Codex +1 283установок agent-ready Скилл agent-ready для Claude Code и Codex превращает отчёты о готовности сайта для агентов и логи 404 в изменения сайта, тесты и проверку ответов. Выявляет проблемы с обнаружением страниц документации агентами. CX Codex +1 257установок ci-speedup Скилл ci-speedup для Claude Code находит, где изменения ждут между отправкой и деплоем, и помогает перестроить этот участок CI. Разбирает задержки при росте очереди слияния или частых сбоях основной ветки. CX Codex +1 250установок

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

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