{"id":"611454cc-cda3-404e-bed9-1cf8c1e07532","shortId":"fSzCan","kind":"skill","title":"verification-before-completion","tagline":"Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always","description":"# Verification Before Completion\n\n## Overview\n\n**Announce at start:** \"Verification Before Completion skill activated.\"\n\nClaiming work is complete without verification is dishonesty, not efficiency.\n\n**Core principle:** Evidence before claims, always.\n\n**Violating the letter of this rule is violating the spirit of this rule.**\n\n## The Iron Law\n\n```\nNO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE\n```\n\nIf you haven't run the verification command in this message, you cannot claim it passes.\n\n## The Gate Function\n\n```\nBEFORE claiming any status or expressing satisfaction:\n\n1. IDENTIFY: What command proves this claim?\n2. RUN: Execute the FULL command (fresh, complete)\n3. READ: Full output, check exit code, count failures\n4. VERIFY: Does output confirm the claim?\n   - If NO: State actual status with evidence\n   - If YES: State claim WITH evidence\n5. ONLY THEN: Make the claim\n\nSkip any step = lying, not verifying\n```\n\n## Common Failures\n\n| Claim | Requires | Not Sufficient |\n|-------|----------|----------------|\n| Tests pass | Test command output: 0 failures | Previous run, \"should pass\" |\n| Linter clean | Linter output: 0 errors | Partial check, extrapolation |\n| Build succeeds | Build command: exit 0 | Linter passing, logs look good |\n| Bug fixed | Test original symptom: passes | Code changed, assumed fixed |\n| Regression test works | Red-green cycle verified | Test passes once |\n| Agent completed | VCS diff shows changes | Agent reports \"success\" |\n| Requirements met | Line-by-line checklist | Tests passing |\n\n## Red Flags - STOP\n\n- Using \"should\", \"probably\", \"seems to\"\n- Expressing satisfaction before verification (\"Great!\", \"Perfect!\", \"Done!\", etc.)\n- About to commit/push/PR without verification\n- Trusting agent success reports\n- Relying on partial verification\n- Thinking \"just this once\"\n- Tired and wanting work over\n- **ANY wording implying success without having run verification**\n\n## Rationalization Prevention\n\n| Excuse | Reality |\n|--------|---------|\n| \"Should work now\" | RUN the verification |\n| \"I'm confident\" | Confidence ≠ evidence |\n| \"Just this once\" | No exceptions |\n| \"Linter passed\" | Linter ≠ compiler |\n| \"Agent said success\" | Verify independently |\n| \"I'm tired\" | Exhaustion ≠ excuse |\n| \"Partial check is enough\" | Partial proves nothing |\n| \"Different words so rule doesn't apply\" | Spirit over letter |\n\n## Key Patterns\n\n**Tests:**\n```\n✅ [Run test command] [See: 34/34 pass] \"All tests pass\"\n❌ \"Should pass now\" / \"Looks correct\"\n```\n\n**Regression tests (TDD Red-Green):**\n```\n✅ Write → Run (pass) → Revert fix → Run (MUST FAIL) → Restore → Run (pass)\n❌ \"I've written a regression test\" (without red-green verification)\n```\n\n**Build:**\n```\n✅ [Run build] [See: exit 0] \"Build passes\"\n❌ \"Linter passed\" (linter doesn't check compilation)\n```\n\n**Requirements:**\n```\n✅ Re-read plan → Create checklist → Verify each → Report gaps or completion\n❌ \"Tests pass, phase complete\"\n```\n\n**Agent delegation:**\n```\n✅ Agent reports success → Check VCS diff → Verify changes → Report actual state\n❌ Trust agent report\n```\n\n## Why This Matters\n\nFrom 24 failure memories:\n- your human partner said \"I don't believe you\" - trust broken\n- Undefined functions shipped - would crash\n- Missing requirements shipped - incomplete features\n- Time wasted on false completion → redirect → rework\n- Violates: \"Honesty is a core value. If you lie, you'll be replaced.\"\n\n## When To Apply\n\n**ALWAYS before:**\n- ANY variation of success/completion claims\n- ANY expression of satisfaction\n- ANY positive statement about work state\n- Committing, PR creation, task completion\n- Moving to next task\n- Delegating to agents\n\n**Rule applies to:**\n- Exact phrases\n- Paraphrases and synonyms\n- Implications of success\n- ANY communication suggesting completion/correctness\n\n## The Bottom Line\n\n**No shortcuts for verification.**\n\nRun the command. Read the output. THEN claim the result.\n\nThis is non-negotiable.","tags":["verification","before","completion","coco","rkz91","agent-skills","agents-md","ai-agents","claude-code","codex","cursor","developer-tools"],"capabilities":["skill","source-rkz91","skill-verification-before-completion","topic-agent-skills","topic-agents-md","topic-ai-agents","topic-claude-code","topic-codex","topic-cursor","topic-developer-tools","topic-llm-tools","topic-mcp","topic-pm-tools","topic-product-management","topic-productivity"],"categories":["coco"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/rkz91/coco/verification-before-completion","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add rkz91/coco","source_repo":"https://github.com/rkz91/coco","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (3,937 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:10.216Z","embedding":null,"createdAt":"2026-05-18T13:21:43.793Z","updatedAt":"2026-05-18T19:14:10.216Z","lastSeenAt":"2026-05-18T19:14:10.216Z","tsv":"'0':181,191,201,393 '1':114 '2':121 '24':440 '3':129 '34/34':350 '4':138 '5':158 'activ':48 'actual':148,431 'agent':228,234,268,316,420,422,434,515 'alway':36,64,487 'announc':41 'appli':339,486,517 'assert':35 'assum':215 'believ':450 'bottom':532 'broken':453 'bug':207 'build':196,198,388,390,394 'cannot':100 'chang':214,233,429 'check':133,194,327,401,425 'checklist':243,409 'claim':9,32,49,63,83,101,108,120,144,155,163,172,493,545 'clean':188 'code':135,213 'command':24,95,117,126,179,199,348,540 'commit':17,504 'commit/push/pr':264 'common':170 'communic':528 'compil':315,402 'complet':4,12,39,46,52,82,128,229,415,419,468,508 'completion/correctness':530 'confid':304,305 'confirm':26,142 'core':59,475 'correct':359 'count':136 'crash':458 'creat':19,408 'creation':506 'cycl':223 'deleg':421,513 'diff':231,427 'differ':333 'dishonesti':56 'doesn':337,399 'done':260 'effici':58 'enough':329 'error':192 'etc':261 'evid':33,61,87,151,157,306 'exact':519 'except':311 'excus':294,325 'execut':123 'exhaust':324 'exit':134,200,392 'express':112,254,495 'extrapol':195 'fail':373 'failur':137,171,182,441 'fals':467 'featur':463 'fix':13,208,216,370 'flag':247 'fresh':85,127 'full':125,131 'function':106,455 'gap':413 'gate':105 'good':206 'great':258 'green':222,365,386 'haven':90 'honesti':472 'human':444 'identifi':115 'impli':286 'implic':524 'incomplet':462 'independ':320 'iron':79 'key':343 'law':80 'letter':67,342 'lie':167,479 'line':240,242,533 'line-by-lin':239 'linter':187,189,202,312,314,396,398 'll':481 'log':204 'look':205,358 'm':303,322 'make':29,161 'matter':438 'memori':442 'messag':98 'met':238 'miss':459 'move':509 'must':372 'negoti':552 'next':511 'non':551 'non-negoti':550 'noth':332 'origin':210 'output':27,132,141,180,190,543 'overview':40 'paraphras':521 'partial':193,273,326,330 'partner':445 'pass':15,103,177,186,203,212,226,245,313,351,354,356,368,376,395,397,417 'pattern':344 'perfect':259 'phase':418 'phrase':520 'plan':407 'posit':499 'pr':505 'prevent':293 'previous':183 'principl':60 'probabl':251 'prove':118,331 'prs':20 'ration':292 're':405 're-read':404 'read':130,406,541 'realiti':295 'red':221,246,364,385 'red-green':220,363,384 'redirect':469 'regress':217,360,381 'reli':271 'replac':483 'report':235,270,412,423,430,435 'requir':21,173,237,403,460 'restor':374 'result':547 'revert':369 'rework':470 'rule':70,77,336,516 'run':22,92,122,184,290,299,346,367,371,375,389,538 'said':317,446 'satisfact':113,255,497 'see':349,391 'seem':252 'ship':456,461 'shortcut':535 'show':232 'skill':47 'skill-verification-before-completion' 'skip':164 'source-rkz91' 'spirit':74,340 'start':43 'state':147,154,432,503 'statement':500 'status':110,149 'step':166 'stop':248 'succeed':197 'success':31,236,269,287,318,424,526 'success/completion':492 'suffici':175 'suggest':529 'symptom':211 'synonym':523 'task':507,512 'tdd':362 'test':176,178,209,218,225,244,345,347,353,361,382,416 'think':275 'time':464 'tire':279,323 'topic-agent-skills' 'topic-agents-md' 'topic-ai-agents' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-developer-tools' 'topic-llm-tools' 'topic-mcp' 'topic-pm-tools' 'topic-product-management' 'topic-productivity' 'trust':267,433,452 'undefin':454 'use':5,249 'valu':476 'variat':490 'vcs':230,426 've':378 'verif':2,23,37,44,54,86,94,257,266,274,291,301,387,537 'verifi':139,169,224,319,410,428 'verification-before-complet':1 'violat':65,72,471 'want':281 'wast':465 'without':53,84,265,288,383 'word':285,334 'work':10,50,219,282,297,502 'would':457 'write':366 'written':379 'yes':153","prices":[{"id":"1895d307-2fa6-4dcb-a3a4-850999ba3084","listingId":"611454cc-cda3-404e-bed9-1cf8c1e07532","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"rkz91","category":"coco","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:43.793Z"}],"sources":[{"listingId":"611454cc-cda3-404e-bed9-1cf8c1e07532","source":"github","sourceId":"rkz91/coco/verification-before-completion","sourceUrl":"https://github.com/rkz91/coco/tree/main/skills/verification-before-completion","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:43.793Z","lastSeenAt":"2026-05-18T19:14:10.216Z"}],"details":{"listingId":"611454cc-cda3-404e-bed9-1cf8c1e07532","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"rkz91","slug":"verification-before-completion","github":{"repo":"rkz91/coco","stars":7,"topics":["agent-skills","agents-md","ai","ai-agents","claude-code","codex","cursor","developer-tools","llm-tools","mcp","pm-tools","product-management","productivity","prompt-engineering","workflow-automation"],"license":"mit","html_url":"https://github.com/rkz91/coco","pushed_at":"2026-04-26T01:51:27Z","description":"Open-source library of AI superpowers — 59 skills, 34 commands, 10 agents + 24 GSD subagents, 3 system bundles. An entire team, wherever your AI lives. Vendor-neutral across Claude Code, Cursor, Codex, and any AGENTS.md tool.","skill_md_sha":"e12c37eb103ee2e653ae7f9de2b5d6d11dd8a810","skill_md_path":"skills/verification-before-completion/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/rkz91/coco/tree/main/skills/verification-before-completion"},"layout":"multi","source":"github","category":"coco","frontmatter":{"name":"verification-before-completion","description":"Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always"},"skills_sh_url":"https://skills.sh/rkz91/coco/verification-before-completion"},"updatedAt":"2026-05-18T19:14:10.216Z"}}