forge-metrics

Compute plan health metrics from Forge PLAN.md and tasks.

Updated Feb 23, 2026
One-click install
npx skills add https://github.com/whatwecando/dagsmith --skill forge-metrics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forge-metrics
Source: https://github.com/whatwecando/dagsmith/tree/main/templates/skills/forge-metrics
Command: npx skills add https://github.com/whatwecando/dagsmith --skill forge-metrics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan health and progress visibility for Forge projects by aggregating and presenting metrics from the current plan.

Core Features & Use Cases

  • Plan health metrics: counts and statuses of tasks, waves, and dependencies to assess progress.
  • Parallelism & DAG insights: reports on wave concurrency and longest dependency chains.
  • Coverage & risk visibility: identifies feature references and remaining work to spot gaps or risks.

Quick Start

Run the metrics tool to generate a readable health report for the active plan.

Frequently Asked Questions about forge-metrics

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

FAQPage Schema
How do I check project plan health and task status from a markdown workspace?

To check project plan health, the system reads the .planning directory to compute task statuses, wave concurrency, and DAG depth. It aggregates this data to provide a structured summary of remaining work and overall progress visibility for your project.

What do task waves and DAG depth indicate in project management metrics?

In project management metrics, task waves indicate parallelism and concurrency potential, while DAG depth measures the longest dependency chain. These indicators help assess execution bottlenecks and determine how efficiently remaining work can be processed in parallel.

How do I generate a health report for my current Forge plan?

You generate a health report by running the metrics tool against your active project workspace. It automatically extracts task counts, feature coverage, and atomicity metrics from your existing plan files to produce a readable summary of current project status.

Can I measure feature coverage and task atomicity without manual tracking?

Yes, you can measure feature coverage and task atomicity automatically by scanning your plan files. The tool identifies feature references and evaluates task structures within the workspace, eliminating the need for manual tracking while highlighting potential coverage gaps or risks.

Does this metrics tool work without external dependencies or plugins?

No external dependencies or plugins are required. The tool operates directly on your project workspace by reading the .planning directory structure, computing task metrics, and surfacing project health insights without needing additional software installations.

What is the best way to identify remaining work and bottlenecks in a task plan?

The best way to identify remaining work and bottlenecks is by analyzing the plan's DAG depth and wave concurrency. This approach surfaces the longest dependency chains and highlights parallelism limits, allowing you to spot execution risks and gaps effectively.