skills.rest
maxwell2732
maxwell2732COMMUNITY
Explore all skills by this author →
Website𝕏@ChenZhu_CAUGitHub

harness-progress

Aggregate cc:TODO, cc:WIP, and cc:done entries from Plans.md into a JSON progress snapshot.

39|46|Updated May 29, 2026
Search Tags:#html#dashboard#drift#progress#state#tracker#plans.md
One-click install
npx skills add https://github.com/maxwell2732/claudecode-research-harness-workflow --skill harness-progress-maxwell2732
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness-progress
Source: https://github.com/maxwell2732/claudecode-research-harness-workflow/tree/main/skills/harness-progress
Command: npx skills add https://github.com/maxwell2732/claudecode-research-harness-workflow --skill harness-progress-maxwell2732

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly understand the status of a research harness session by summarizing tasks from Plans.md into a compact, visual progress snapshot that non-engineers can grasp at a glance.

Core Features & Use Cases

  • Generate a single-page progress snapshot from Plans.md that aggregates cc:TODO, cc:WIP, and cc:done counts, computes progress percentage, and displays elapsed/estimated time and cost metrics.
  • Render an HTML dashboard that can be regenerated on demand to reflect the current plan state, enabling rapid status checks and decision-making.
  • Use Case: project leads review the session trajectory in seconds without parsing the full Plans.md, ensuring alignment with plan milestones.

Quick Start

Generate a single-file HTML progress snapshot from Plans.md for the current project and open it in a browser.

Frequently Asked Questions about harness-progress

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

FAQPage Schema
How do I generate an HTML dashboard from Plans.md to track session progress?▼

The Skill generates an HTML dashboard by aggregating cc:TODO, cc:WIP, and cc:done entries from Plans.md, computing progress percentage, and rendering a visual snapshot with elapsed time and drift alerts.

What is a progress snapshot and how does it summarize task state from a markdown plan?▼

A progress snapshot is a JSON payload conforming to progress-snapshot.v1 that summarizes task state by aggregating cc:TODO, cc:WIP, and cc:done counts from Plans.md, computing progress percentage and displaying drift alerts for rapid review.

How do I calculate progress percentage and drift alerts from cc:TODO and cc:WIP tags?▼

Progress percentage and drift alerts are calculated by evaluating cc:TODO, cc:WIP, and cc:done entries within Plans.md, comparing elapsed time against estimated time to flag schedule deviations in the rendered HTML dashboard.

What happens if Plans.md or state files are missing when generating a progress tracker?▼

If Plans.md or state files are missing, the progress tracker handles the absence gracefully by returning safe defaults and emitting clear error messages instead of failing the dashboard generation process.

Can I scope progress snapshot generation to only the current repository project?▼

Yes, the progress snapshot operation is scoped to the current repository project, ensuring the aggregated cc:TODO, cc:WIP, and cc:done entries and resulting HTML dashboard reflect only the localized plan state.

Does the HTML dashboard display cost metrics and estimated time alongside task state?▼

Yes, the HTML dashboard displays cost metrics, elapsed time, and estimated time alongside the aggregated task state, enabling project leads to review the session trajectory in seconds without parsing the full Plans.md.

Related Skills

Explore More Data & Analytics Skills→
lane2077lane2077

harness-sync

Synchronizes Plans.md tasks with actual implementation progress via drift detection and status marker updates.

Community
Intermediate
krzemienskikrzemienski
2

architecture-evolution-tracking

Detect architectural drift from ADRs and compute alignment scores.

Community
Advanced
microsoftmicrosoft
19

state-management

Manage upgrade workflow state by updating tasks.md and scenario-instructions.md files.

Official
Intermediate
b4CU-R4Ub4CU-R4U
1

Project Context Navigator

Aggregate project state into a unified context dashboard with pipeline detection.

Community
Intermediate