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.