complete-task

Archives completed or cancelled tasks after acceptance checks, harvest entries, and ledger validation.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/toderian/project_template --skill complete-task-toderian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: complete-task
Source: https://github.com/toderian/project_template/tree/main/plugins/agents-tasks/skills/complete-task
Command: npx skills add https://github.com/toderian/project_template --skill complete-task-toderian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finished work often stays stuck in the active task folder because the closeout step was skipped, leaving stale progress markers, unsynced ledgers, and no record of what was actually delivered. This Skill closes out a task safely by verifying acceptance criteria, reconciling progress, harvesting outcomes, and archiving the task only when everything agrees. ## Core Features & Use Cases - Verified closeout: Checks acceptance criteria, phase items, spec references, and listed tests before marking a task done, and records reasons for cancelled tasks. - Completion harvest and summary: Appends a final execution log, fills completion harvest rows (resource updates, follow-ups, decisions), and writes a completion summary including run-state rulings. - Archive and ledger sync: Moves the task file to the archive directory, removes stale run directories, runs ledger sync and strict validation, and optionally squashes task commits. - Use Case: After implementing an authentication feature tracked as AUTH-001, ask the agent to complete the task; it verifies tests, updates the spec status, harvests follow-ups, archives the file, and confirms the ledger passes validation. ## Quick Start Ask the agent to complete task AUTH-001 and archive it once acceptance checks and ledger validation pass.

Frequently Asked Questions about complete-task

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

FAQPage Schema
How do I complete a task in a docs/tasks_manager workflow?

Provide the task ID or its path under docs/tasks_manager/_todos/. The workflow verifies acceptance criteria and tests, appends a final execution log, fills the completion harvest and summary, then moves the file to _todos_archived and syncs the ledgers.

How do I cancel a task instead of marking it done?

State that the task should be cancelled; cancellation is never inferred silently. The workflow records the reason and any partial validation, sets the status to cancelled, and archives the file with harvest rows filled.

What happens if a listed test cannot be run during task closeout?

The exact command attempted and the reason it could not run are recorded in the execution log and completion summary. The task is not marked done on unverified claims; skipped tests are explicitly documented.

Can task commits be squashed after the task is archived?

Yes, but only after the task is verified done, archived, synced, and strictly validated. The squash is routed through the agents-core:squash-workspace-commits skill, which enforces backup refs and refuses pushed or shared history.

What are the prerequisites for using this task closeout workflow?

The project must have docs/tasks_manager initialized, which can be created with at init --with-tasks. Multi-phase tasks should also run the verify-task skill first so its verdict informs the closeout.