plan-status

Parse plan frontmatter to output a numeric progress metric with active task highlight.

6|1|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/JordanGunn/skills --skill plan-status-jordangunn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-status
Source: https://github.com/JordanGunn/skills/tree/main/skills/plan/status
Command: npx skills add https://github.com/JordanGunn/skills --skill plan-status-jordangunn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Tracking the status of a multi-phase plan can be tedious when you must inspect multiple files. This skill provides a centralized view by parsing frontmatter to show progress and active work at a glance.

Core Features & Use Cases

  • Parses plan.md frontmatter to determine overall plan status and per-subplan statuses.
  • Reads roman-numeral task frontmatters (i, ii, iii, ...) to classify each task as complete, in_progress, or pending.
  • Outputs a human-readable report with an active task highlight and a Progress line, helping managers and engineers monitor progress in real-time.

Quick Start

Run the status script for a phase to generate a live status report.

Frequently Asked Questions about plan-status

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

FAQPage Schema
How do I track execution progress for a multi-phase plan in markdown?

Track multi-phase plan execution by parsing markdown frontmatter to generate a centralized status report. It reads plan.md and index.md files to output a numeric progress metric and highlight active tasks.

How does frontmatter parsing classify task statuses across subplans?

Frontmatter parsing classifies task statuses by reading roman-numeral identifiers (i, ii, iii) within subplans to mark each task as complete, in_progress, or pending, aggregating these into an overall plan status.

Can I generate a plan status report using PowerShell on Windows?

Yes, you can generate a plan status report using PowerShell. The script supports both UNIX-like shells and PowerShell environments to parse phase-based planning frontmatter and output progress metrics.

What is the best way to display an at-a-glance status for phase-based planning?

The best way to display at-a-glance status is running a script that parses plan frontmatter to produce a human-readable report with a Progress line and an active task highlight for real-time monitoring.

What file structure do I need to track plan execution status with this script?

You need a plan.md file, an index.md file, and individual task files with roman-numeral frontmatters. This structure allows the script to parse phases, subplans, and per-task statuses correctly.

Why does my plan status report show incomplete progress metrics?

Plan status reports show incomplete progress metrics when task frontmatters lack valid roman-numeral identifiers or statuses. Ensure all subplan tasks are correctly marked complete, in_progress, or pending for accurate tracking.