{
  "id": "verification-before-completion",
  "handle": "verification-before-completion",
  "canonicalUrl": "https://bestskillsforclaude.com/en/skills/verification-before-completion",
  "language": "en",
  "alternates": {
    "en": "https://bestskillsforclaude.com/en/skills/verification-before-completion",
    "es": "https://bestskillsforclaude.com/es/skills/verification-before-completion",
    "pt-BR": "https://bestskillsforclaude.com/pt-br/skills/verification-before-completion",
    "ja": "https://bestskillsforclaude.com/ja/skills/verification-before-completion"
  },
  "category": {
    "id": "engineering-discipline",
    "name": "Engineering discipline"
  },
  "publisher": {
    "name": "Jesse Vincent (obra)",
    "url": "https://github.com/obra"
  },
  "source": "https://github.com/obra/superpowers",
  "documentation": null,
  "licenseAsStated": "MIT",
  "runtime": "Claude Code and other supported coding agents",
  "lastReviewed": "2026-08-05",
  "headline": "How do you stop an agent saying done when it is not?",
  "summary": "By making evidence, not confidence, the condition for finishing.",
  "verdict": "The verification-before-completion skill requires the agent to check its work and present evidence before declaring a task complete. It is the smallest, highest leverage discipline skill in the superpowers set, because the false done report is the failure that costs the most trust and the most rework.",
  "bestFor": "Every agent workflow where somebody else acts on the claim that work is finished.",
  "skipIf": "You review every change yourself in detail anyway, and the loop is short enough that the extra step is noise.",
  "keyTakeaways": [
    "The cost of a false done is paid later, by someone with less context.",
    "Define what counts as evidence per task, or you will get whatever is easiest to produce.",
    "It combines directly with webapp-testing, which is how the evidence gets produced.",
    "It is a habit, not a guarantee. An agent can still verify the wrong thing carefully."
  ],
  "quickStart": [
    "Install superpowers from obra/superpowers, published under MIT.",
    "Say what evidence counts for this task, for example a passing test, a screenshot or a request log.",
    "Reject completion reports that contain conclusions but no observations."
  ],
  "sections": [
    {
      "heading": "What it changes in practice",
      "paragraphs": [
        "Agents do not lie so much as conclude early. The code looks right, the reasoning is coherent, and the report of success is generated with the same confidence as everything else. Requiring evidence changes what the report is made of.",
        "It also changes review. Reading actions and observations takes seconds, whereas reconstructing whether a change works from a diff takes far longer and is often skipped."
      ]
    },
    {
      "heading": "Where it disappoints",
      "paragraphs": [
        "Verifying the wrong thing is still possible. A screenshot of the wrong page is evidence of nothing, so what counts as evidence has to be stated per task.",
        "It also adds a step to short loops where you would have checked yourself anyway, which is the one case where the overhead is real."
      ]
    }
  ],
  "faq": [
    {
      "question": "What counts as evidence?",
      "answer": "Something observed rather than concluded: a test result, a screenshot, a log line, a response body. Say which one you want."
    },
    {
      "question": "Does it slow work down?",
      "answer": "Slightly per task, and much less than the rework caused by acting on a false completion report."
    },
    {
      "question": "Does it work with other skills?",
      "answer": "Yes. webapp-testing produces the evidence, this skill makes producing it non optional."
    }
  ],
  "sources": [
    {
      "label": "obra/superpowers on GitHub",
      "url": "https://github.com/obra/superpowers",
      "kind": "repository"
    },
    {
      "label": "Agent skills directory listing",
      "url": "https://skills.sh",
      "kind": "directory"
    }
  ],
  "machineReadable": {
    "markdown": "https://bestskillsforclaude.com/en/skills/verification-before-completion/content.md",
    "json": "https://bestskillsforclaude.com/en/skills/verification-before-completion/skill.json"
  },
  "disclosure": "Editorial desk review based on the publisher's own repository. Not a security audit, a benchmark or a guarantee of maintenance."
}