speckit-complete

Generates completion-report.md from tasks.md and implement.log.md to close an implement run.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-complete-narenkarthikbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-complete
Source: https://github.com/NarenKarthikBM/specseyal/tree/main/.claude/skills/speckit-complete
Command: npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-complete-narenkarthikbm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a spec-driven implementation run finishes, there is no trustworthy record of what actually happened unless someone writes it down accurately. This Skill closes out an implement run by re-reading tasks.md and implement.log.md from disk on every invocation and authoring a validated completion-report.md, so the pipeline's historical record reflects what is on disk rather than what the model happens to remember. ## Core Features & Use Cases - Disk-grounded reporting: Re-reads tasks.md and implement.log.md in full on every run (rule R1-S02), never authoring the report from retained context, so reports stay accurate across compactions, clears, and resumed sessions. - Contract-validated output: Writes completion-report.md in the exact format docs/contracts/completion-report.md fixes — frontmatter status in {success, partial, failed} plus seven ordered core sections ending in a Telemetry section. - Telemetry rollup: Computes per-phase and total token/duration figures via cost_evidence.py and phase_scope.py, relaying values verbatim with FULL / PARTIAL (lower bound) / NO SIGNAL / UNAVAILABLE labels. - Use Case: After running /speckit-implement-parallel on a feature, invoke /speckit-complete to produce the completion report that downstream phases (like the testing doc's coverage map) and hooks (after_complete) depend on. ## Quick Start Run /speckit-complete with no arguments after an implement run to generate the current feature's completion-report.md from its tasks.md and implement.log.md.

Frequently Asked Questions about speckit-complete

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

FAQPage Schema
How do I generate a completion report after a spec-kit implement run?

Run /speckit-complete with no arguments. It resolves the current feature via .specify/feature.json, re-reads tasks.md and implement.log.md from disk, and writes completion-report.md in the contract-defined format with a success, partial, or failed status.

What inputs does the completion report require?

The report requires tasks.md from /speckit-tasks or /speckit-tasks-graph, and ordinarily implement.log.md from /speckit-implement-parallel or /speckit-implement. If no tasks are completed and no log exists, the command errors and tells you to run an implement phase first.

Can the completion report be generated if implement.log.md is missing?

Yes, but only when tasks.md shows completed tasks, which happens when a trivial feature was implemented inline without wave orchestration. The report then notes waves run as 0 (inline). If no tasks are complete and no log exists, the command stops with an error.

Why does the skill re-read files from disk instead of using conversation context?

Rule R1-S02 mandates re-reading tasks.md and implement.log.md from disk on every invocation because retained context can be stale after compaction, /clear, or resumed sessions. The report's contract validates structure, not content accuracy, so only a fresh disk read guarantees the record matches reality.

What happens if a previous completion-report.md already exists?

A prior report is not an error and there is no already-done short-circuit. Every invocation re-derives the report from the current tasks.md and implement.log.md and overwrites the prior file, noting in the report if nothing has changed.