forge-progress

Extract project progress metrics from planning and state documents.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/whatwecando/tombola --skill forge-progress
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forge-progress
Source: https://github.com/whatwecando/tombola/tree/main/.claude/skills/forge-progress
Command: npx skills add https://github.com/whatwecando/tombola --skill forge-progress

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Display a progress dashboard for monitoring project execution by aggregating planning data and state updates.

Core Features & Use Cases

  • Read planning and state files to compute metrics such as total tasks, completed, failed, skipped, blocked, and completion percentage.
  • Determine current phase and wave, remaining waves, and list blockers from STATE.md.
  • Show feature coverage and a timeline comparing estimated vs actual progress.

Quick Start

Read .planning/PLAN.md and .planning/STATE.md and render the progress dashboard.

Frequently Asked Questions about forge-progress

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a project progress dashboard from planning files?

Generate a project progress dashboard by reading .planning/PLAN.md and .planning/STATE.md files to compute total tasks, completion percentage, phase progression, and blockers for agile or staged projects.

What metrics are included in a sprint progress dashboard?

A sprint progress dashboard includes total tasks, completed, failed, skipped, blocked, and completion percentage metrics, along with current phase, wave, remaining waves, and listed blockers from state documents.

How do I track blockers and completion percentage in agile project management?

Track blockers and completion percentage by extracting deterministic data from STATE.md files, which lists current blockers and computes completion metrics for monitoring agile project execution.

Does the progress dashboard work with missing planning or state data?

The progress dashboard includes error handling for missing data, ensuring deterministic extraction from .planning files even when planning or state documents are incomplete or absent.

Can I compare estimated vs actual progress timeline for project phases?

Compare estimated vs actual progress timeline by extracting phase progression and wave data from planning documents, generating a dashboard-ready summary that visualizes feature coverage and timeline discrepancies.

What is the best way to monitor task counts across multiple project waves?

Monitor task counts across multiple project waves by reading .planning files to determine the current phase, remaining waves, and aggregate task counts for staged project execution tracking.