name: progress-report
description: >
Displays progress dashboard showing phase completion, blocked tasks,
and remaining work estimate. Provides at-a-glance view of implementation
status. Run anytime to check progress.
version: 0.0.1
license: MIT
compatibility: Requires tasks.md
metadata:
author: drillan
category: reporting
repository: https://github.com/drillan/speckit-gates

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

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