task-completion-report

Parse tasks.md to compute per-phase and overall completion percentages.

Updated Nov 19, 2025

Search Tags:#automation #reports #milestones #task-completion #phase-analysis #progress-tracking

Ready to run

npx skills add https://github.com/NarubyRiverlione/FishBowl --skill task-completion-report

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: task-completion-report
Source: https://github.com/NarubyRiverlione/FishBowl/tree/main/.claude/skills/task-completion-report
Command: npx skills add https://github.com/NarubyRiverlione/FishBowl --skill task-completion-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automatically analyzes milestone specs to generate a comprehensive task-completion report, helping teams quantify progress, spot bottlenecks, and decide when a milestone is ready for review or release.

Core Features & Use Cases

Overall completion: Compute total tasks completed vs. total tasks across phases and present an overall percentage with a clear status.
Phase breakdown: Show per-phase completion with visual progress bars and counts.
Release readiness insights: Identify blockers and provide actionable next steps for PRs or milestones.
Flexible data sources: Works with core milestones like specs/001-core-mechanics or specs/002-visual-prototype.

Quick Start

Run the core mechanics report with: pnpm report:tasks:001 Or analyze a different milestone: python3 scripts/task-completion-report.py specs/001-core-mechanics/tasks.md

Frequently Asked Questions about task-completion-report

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

FAQPage Schema

How do I generate a task completion report for my milestone?▼

Task completion reports analyze your tasks.md file to count completed versus incomplete tasks across phases, compute overall and per-phase completion percentages, and output a formatted report with progress bars and status indicators. Run `python3 scripts/task-completion-report.py specs/[milestone]/tasks.md` to generate one for any milestone.

What does a task completion report tell me about milestone readiness?▼

A task completion report quantifies progress by phase, identifies blockers, and provides actionable next steps to determine if a milestone is ready for PR or merge. It shows overall completion percentage alongside per-phase breakdowns so teams can spot which phases are bottlenecks.

Can I use task completion reports to track progress across multiple milestones?▼

Yes, task completion reports work with any milestone spec that contains a tasks.md file. You can run the report against core milestones like specs/001-core-mechanics or specs/002-visual-prototype to compare progress across phases and milestones.

What file format does the task completion report require?▼

Task completion reports parse tasks.md files structured by phase. The report detects phases within the file, counts task completion status, and renders a formatted output with completion percentages and visual progress indicators.

How are task phases detected and summarized in the report?▼

The report automatically detects phases within tasks.md, counts total and completed tasks per phase, computes phase-level completion percentages, and displays them alongside an overall completion status with visual progress bars for immediate readability.