# Progress Report

> 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.

- Skill: `drillan/progress-report` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add drillan/progress-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/drillan/progress-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: MIT
- Author: drillan (https://skillmd.com/u/drillan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/drillan/progress-report

---


# 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:

```bash
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