skills.rest
NarubyRiverlione
NarubyRiverlioneCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/NarubyRiverlione/FishBowl --skill task-completion-report
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Data & Analytics Skills→
chaimtchaimt

adlc-product-roadmap

Analyze feature specs and tasks.md to compute milestone progress and update PDR records.

Community
Advanced
brand6brand6

sprint-plan

Generate and update sprint plans from milestones, capacity, and completed work.

Community
Advanced
dobrinz123dobrinz123

gsd-stats

Generate consolidated project statistics from phases, plans, requirements, and git history.

Community
Intermediate
sfinessfines

bmad-sprint-planning

Parse epic files, detect story statuses, and generate sprint-status.yaml files.

Community
Intermediate