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
| Code | Status | Meaning | |------|--------|---------| | 0 | Success | Report generated | | 3 | Error | tasks.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