mcpField
P
progress-report

progress-report

github.com/drillanAgent workflows3145 installsUpdated 41w ago
Repository

About progress-report

A manual skill that generates an implementation progress dashboard from tasks.md. It helps project contributors review phase completion, blocked and potentially complete tasks, and remaining work.

Key features

  1. 01Show overall completion percentage
  2. 02Break down progress by phase
  3. 03List blocked tasks
  4. 04Flag potentially complete tasks
  5. 05Estimate remaining work

Use cases

  1. 01Review implementation status across phases
  2. 02Identify tasks waiting on dependencies
  3. 03Check whether existing files match unfinished tasks

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/drillan/speckit-gates --skill progress-report

After installing, type/progress-reportin Claude Code to confirm it loaded.

Bundled filesscripts/report.sh

Details

From the project README

progress-report

Displays a progress dashboard showing implementation status.

Purpose

This skill provides an at-a-glance view of your implementation progress:

  • Phase completion: Progress bar for each phase in tasks.md
  • Blocked tasks: Highlights tasks that are blocked
  • Potentially complete: Tasks that may be done but not marked
  • Remaining work: Estimate of remaining tasks

Output

The skill outputs a ProgressDashboard with:

  • Overall completion percentage
  • Per-phase progress breakdown
  • List of blocked tasks
  • Potentially complete tasks (based on file existence)
  • Remaining work estimate

Usage

This is a manual skill - run it anytime to check progress:

npx skills run progress-report

Or via AI agent:

User: Show me the progress report

Exit Codes

CodeStatusMeaning
0SuccessReport generated
3Errortasks.md missing

Dashboard Sections

Overall Progress
Overall Progress: [##########----------] 50% (25/50 tasks)
Phase Breakdown
| Phase | Progress | Completed | Total |
|-------|----------|-----------|-------|
| Setup | [####----] 50% | 2 | 4 |
| Core  | [########] 100% | 10 | 10 |
| Tests | [##------] 25% | 3 | 12 |
Blocked Tasks

Tasks that cannot proceed due to dependencies or issues:

- T015: Waiting for API specification
- T023: Blocked by T015
Potentially Complete

Tasks that reference files which already exist (FR-031a):

- T008: File skills/planning-validate/SKILL.md exists
- T009: File skills/planning-validate/scripts/validate.sh exists
Remaining Work
- Incomplete tasks: 25
- Blocked tasks: 2

Detection Logic

Blocked Tasks

A task is considered blocked if:

  • Its description contains "blocked" or "waiting"
  • It depends on an incomplete task (future enhancement)
Potentially Complete Tasks

A task is potentially complete if:

  • It references a file path that exists
  • File was created/modified recently
  • Task is not yet marked as complete

Comments

Markdown supported