Agentskillz Logo

obra/superpowers / verification-before-completion

verification-before-completion

Установки
194,741
Автор
obra/superpowers

Скилл требует подтверждать выполнение работы свежими результатами проверок, а не предположениями. Перед любым заявлением о готовности, успехе или исправлении ошибки нужно запустить соответствующую команду и убедиться в её выводе. Помогает избегать ложных отчётов и поверхностных оценок, заставляя опираться на факты, а не на уверенность или слова агентов.

Установить скилл

npx skills add https://github.com/obra/superpowers --skill verification-before-completion

Аудит безопасности

Gen Agent Trust Hub

pass

This skill acts as a behavioral policy that enforces a 'verification-first' workflow, requiring the agent to prove task completion through command execution and output analysis. It contains no malicious code, external dependencies, or data exfiltration risks.

Audited: 2/17/2026, 6:42:43 PM

Socket

pass

No alerts

Audited: 3/18/2026, 4:47:53 PM

Snyk

pass

Risk: LOW · No issues

Audited: 7/2/2026, 4:28:40 PM

Runlayer

pass

1 file scanned · No issues

Audited: 2/26/2026, 4:22:59 PM

ZeroLeaks

pass

Score: 93/100 · 2 sections analyzed

Audited: 4/16/2026, 10:25:20 AM

Промпт скилла

Verification Before Completion

Overview

Core principle: Evidence before claims, always.

Violating the letter of this rule is violating the spirit of this rule.

The Iron Law

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

If you haven't run the verification command in this message, you cannot claim it passes.

The Gate Function

BEFORE claiming any status or expressing satisfaction:

1. IDENTIFY: What command proves this claim?
2. RUN: Execute the FULL command (fresh, complete)
3. READ: Full output, check exit code, count failures
4. VERIFY: Does output confirm the claim?
   - If NO: State actual status with evidence
   - If YES: State claim WITH evidence
5. ONLY THEN: Make the claim

Skip any step = lying, not verifying

Common Failures

ClaimRequiresNot Sufficient
Tests passTest command output: 0 failuresPrevious run, "should pass"
Linter cleanLinter output: 0 errorsPartial check, extrapolation
Build succeedsBuild command: exit 0Linter passing, logs look good
Bug fixedTest original symptom: passesCode changed, assumed fixed
Regression test worksRed-green cycle verifiedTest passes once
Agent completedVCS diff shows changesAgent reports "success"
Requirements metLine-by-line checklistTests passing

Red Flags - STOP

  • Using "should", "probably", "seems to"
  • Expressing satisfaction before verification ("Great!", "Perfect!", "Done!", etc.)
  • About to commit/push/PR without verification
  • Trusting agent success reports
  • Relying on partial verification
  • Thinking "just this once"
  • Tired and wanting work over
  • ANY wording implying success without having run verification

Rationalization Prevention

ExcuseReality
"Should work now"RUN the verification
"I'm confident"Confidence ≠ evidence
"Just this once"No exceptions
"Linter passed"Linter ≠ compiler
"Agent said success"Verify independently
"I'm tired"Exhaustion ≠ excuse
"Partial check is enough"Partial proves nothing
"Different words so rule doesn't apply"Spirit over letter

Key Patterns

Tests:

✅ [Run test command] [See: 34/34 pass] "All tests pass"
❌ "Should pass now" / "Looks correct"

Regression tests (TDD Red-Green):

✅ Write → Run (pass) → Revert fix → Run (MUST FAIL) → Restore → Run (pass)
❌ "I've written a regression test" (without red-green verification)

Build:

✅ [Run build] [See: exit 0] "Build passes"
❌ "Linter passed" (linter doesn't check compilation)

Requirements:

✅ Re-read plan → Create checklist → Verify each → Report gaps or completion
❌ "Tests pass, phase complete"

Agent delegation:

✅ Agent reports success → Check VCS diff → Verify changes → Report actual state
❌ Trust agent report

When To Apply

ALWAYS before:

  • ANY variation of success/completion claims
  • ANY expression of satisfaction
  • ANY positive statement about work state
  • Committing, PR creation, task completion
  • Moving to next task
  • Delegating to agents

Rule applies to:

  • Exact phrases
  • Paraphrases and synonyms
  • Implications of success
  • ANY communication suggesting completion/correctness

Все файлы скилла

Другие скиллы автора

brainstorming

345,072 установок

obra/superpowers

Превращает сырые идеи в продуманный дизайн и техническое задание до начала разработки. Помогает классифицировать задачу, задавать правильные вопросы, предлагать варианты решений и получать одобрение человека перед написанием кода, чтобы не тратить время на реализацию неверных предположений.

systematic-debugging

242,200 установок

obra/superpowers

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

writing-plans

234,283 установок

obra/superpowers

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

using-superpowers

230,780 установок

obra/superpowers

Этот навык обязывает ИИ перед началом любой работы или ответа проверять наличие подходящих навыков и обязательно их использовать. Он задаёт строгие правила приоритета: сначала процессные навыки (например, мозговой штурм), затем исполнительные. Помогает избегать пропуска важных инструментов и следовать инструкциям.

requesting-code-review

214,263 установок

obra/superpowers

Скилл автоматизирует запрос проверки кода через субагента, изолируя контекст ревью и экономя ресурсы. Он помогает быстро получать обратную связь по изменениям, исправлять критические ошибки и улучшать качество работы.

test-driven-development

212,211 установок

obra/superpowers

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

executing-plans

198,260 установок

obra/superpowers

Скилл для пошагового выполнения письменных планов реализации в отдельной сессии. Загружает план, критически оценивает его, выполняет задачи по шагам с проверками и сообщает о завершении. Останавливается при возникновении препятствий и запрашивает уточнения вместо самостоятельных решений.

subagent-driven-development

191,165 установок

obra/superpowers

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

receiving-code-review

180,519 установок

obra/superpowers

Помогает технически грамотно принимать замечания код-ревью: не соглашаться на словах, а проверять каждое замечание по коду, уточнять неясное и аргументированно возражать, если замечание некорректно. Учит избегать показного согласия и слепо следовать советам, отсекать лишнее и не ломать рабочую функциональность.

dispatching-parallel-agents

177,899 установок

obra/superpowers

Этот навык помогает параллельно выполнять несколько независимых задач, назначая каждому агенту конкретную область и контекст. Он полезен для быстрого исправления ошибок в разных файлах или подсистемах, экономя время и избегая конфликтов.

using-git-worktrees

177,387 установок

obra/superpowers

Скилл помогает организовать изолированное рабочее пространство для работы над задачами с помощью git worktrees. Он определяет, находитесь ли вы уже в таком пространстве, создаёт его через нативные инструменты или git, а затем настраивает проект и проверяет тесты для чистого старта. Полезен, чтобы не мешать текущей ветке и избежать конфликтов.

finishing-a-development-branch

174,077 установок

obra/superpowers

Помогает корректно завершить работу над веткой разработки: проверяет тесты, определяет тип git-окружения и предлагает на выбор локальное слияние, создание пул-реквеста или сохранение ветки как есть. После выбора выполняет интеграцию, очищает рабочее дерево и защищает от случайной потери незакоммиченных файлов.