plan-status

Display the execution status of a plan by parsing frontmatter metadata. Shows progress at-a-glance without requiring manual inspection of each file.

⭐5stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026

When & Why to Use This Skill

The plan-status Claude skill is a powerful utility designed to streamline project tracking by automatically parsing frontmatter metadata from plan files. It provides an instantaneous, high-level overview of execution progress, allowing users and AI agents to identify completed tasks and remaining milestones without the need for manual file-by-file inspection. This skill enhances workflow transparency and ensures that project momentum is maintained through clear, data-driven status reporting.

Use Cases

  • Real-time Progress Tracking: Quickly answer queries like 'what's the status of the plan?' or 'what's left to do?' by generating a consolidated view of the project's current phase.
  • Contextual Workflow Resumption: Use the skill when returning to a complex task to immediately identify the exact point of progress and determine the next logical steps.
  • Automated Status Reporting: Efficiently monitor the execution of multi-step procedures (e.g., in 01_INTENT.md or 02_PROCEDURE.md) by extracting metadata signals to visualize what is 'done' versus 'in-progress'.
nameplan-status
licenseMIT
description>
authorJordan Godau

Instructions

Read all references in references/ before using this skill.

Signals

  • User asks "what's the status of the plan?"
  • User wants to see progress on a phase
  • User asks "what's done?" or "what's left?"
  • Before resuming work on an existing plan

References

Directory: references/

  • 01_INTENT.md
  • 02_PROCEDURE.md

Scripts

Directory: scripts/

  • status.sh: Parses frontmatter and displays plan status (macOS/Linux/WSL)
  • status.ps1: Parses frontmatter and displays plan status (Windows)