# Progress

> View cross-project status synthesis. Read-only report of shipped items, WIP, blockers, and decisions. Use for "/progress project" or "/progress all".

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

---


# /progress — Project Status

Read-only synthesis. Scans vault and outputs status to terminal. Does NOT create files unless --save flag used.

## Context

Today's date: `!date +%Y-%m-%d`

Config: @_core/config.yaml
Processing logic: @_core/PROCESSING.md

## Input

User input: $ARGUMENTS

## Session Task Progress

```
TaskCreate: "Gather project data"
  activeForm: "Scanning vault for project data..."

TaskCreate: "Synthesize report"
  activeForm: "Synthesizing status report..."
```

## Processing Steps

1. **Parse Input**
   - Extract project (or "all" for all projects)
   - Parse timeframe: --week (default), --since {date}

2. **Gather Data**
   - Scan `daily/*.md` for project sections in timeframe
   - Scan `blockers/{project}/*.md` for open blockers
   - Scan `docs/{project}/*.md` for active docs
   - Scan `decisions/{project}/*.md` for recent decisions

3. **Synthesize Report**

## Output Format

```markdown
# {Project} Status

**Period**: {start} → {end}

## Shipped
- {item}

## In Progress
- {item}

## Open Blockers
| Blocker | Severity | Owner | Due |
|---------|----------|-------|-----|
| {title} | {sev}    | {own} | {d} |

**Critical**: {count} blockers due within 2 days

## Active Docs
- {doc} — {status}

## Recent Decisions
- {decision} — {date}
```

**Note**: This command does NOT create any files. Output to terminal only.
Use `--save` to write to `reports/{date}-progress-{project}.md`

## Export (Optional)

Supports `--xlsx`, `--docx`, `--pdf`, `--pptx` flags. See `.claude/rules/export-formats.md` for layout specs and workflow. Complete normal processing first, then generate the formatted file.