done-certificates

Authors task-specific semi-formal done certificates that a separate validating agent discharges.

Updated May 4, 2026
One-click install
npx skills add https://github.com/antstanley/skills --skill done-certificates-antstanley
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: done-certificates
Source: https://github.com/antstanley/skills/tree/main/plugins/spec-planner/skills/done-certificates
Command: npx skills add https://github.com/antstanley/skills --skill done-certificates-antstanley

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? A definition-of-done checklist is only an assertion until someone proves it. This Skill turns each task's definition of done into a structured verification protocol — a done certificate — that names exactly what evidence a validator must collect and which checks to run, so completion is proven rather than assumed. ## Core Features & Use Cases - Certificate authoring: Converts each definition-of-done item into a proof obligation with a claim, precise evidence-to-collect instructions, and function-resolution or regression checks, leaving status and verdict blank for a validator. - spec-planner integration: Writes one certificate per task co-located beside its task file in a spec-planner plan, with two-way links and append-only numbering that moves through backlog, in-progress, and done folders. - Standalone use: Works over any task with acceptance criteria — tickets, PRDs, or issue checklists — writing certificates to .specs/certificates/ when no plan exists. - Use Case: After spec-planner produces a six-task plan for a journal app, ask for done certificates and receive six unverified verification protocols, each naming the exact tests, file locations, and execution traces a validating agent must run to declare the task done. ## Quick Start Ask the agent to add done certificates to each task in your spec-planner plan, or to create a done certificate from a ticket's acceptance criteria.

Frequently Asked Questions about done-certificates

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a done certificate for a task?

Provide a task with a definition of done — a spec-planner task file, a ticket with acceptance criteria, or a PRD 'done when' list — and ask for a done certificate. The Skill writes one obligation per DoD item, each naming the evidence a validator must collect, with status left unverified.

What is the difference between authoring and validating a done certificate?

Authoring writes the verification protocol: obligations, evidence instructions, and the verdict rubric, all left blank. Validating is a separate step where a different agent collects the named evidence, sets each status, and derives the verdict. This Skill only authors; validation happens downstream.

Can I use done certificates without spec-planner?

Yes. Any task with a definition of done works — an issue with acceptance criteria or a feature with a 'done when' list. Standalone certificates are written to .specs/certificates/ and linked to whatever source defines the task's DoD.

Where are done certificates stored in a spec-planner plan?

Each certificate is co-located beside its task file, named NN-snake_case_task-certificate.md, with no dedicated certificates subfolder. It moves with the task through backlog, in-progress, and done folders, and the task header carries a two-way Certificate link.

When should I not write a done certificate?

Skip it when the task has no definition of done and none can be inferred, or when the change is trivial and local, such as a one-line doc fix. In those cases the certificate adds ceremony without rigor.