gsd-progress

Compare STATE.md against disk files to report GSD project progress and next step.

Updated May 11, 2025
One-click install
npx skills add https://github.com/rogsme/dotfiles --skill gsd-progress-rogsme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-progress
Source: https://github.com/rogsme/dotfiles/tree/main/.config/gsd/skills/gsd-progress
Command: npx skills add https://github.com/rogsme/dotfiles --skill gsd-progress-rogsme

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps users track the progress of their Get Stuff Done (GSD) projects, providing a status report and suggesting the next step based on the project's current state.

Core Features & Use Cases

  • Project Status Report: Generates a detailed report on the project's progress, including completed phases, recent work, and open items.
  • Next Step Recommendation: Offers a single, actionable next step for the user, along with alternative suggestions if needed.
  • Read-Only Skill: Cannot be used to make changes to the project, except for the optional fix to a stale STATE.md file.

Quick Start

Use the gsd-progress skill to get an update on your project and see what your next step should be.

Frequently Asked Questions about gsd-progress

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

FAQPage Schema
How do I track project progress and get next step recommendations?

To track project progress and get next step recommendations, you can use a tracking skill that compares a project's STATE.md against actual disk files to generate a status summary and a single actionable next step.

How does comparing STATE.md to disk files work for project status reporting?

Comparing STATE.md to disk files works for project status reporting by scanning the project's .planning directory to identify completed phases, recent work, and open items, offering an accurate progress overview.

Do I need a .planning directory to generate a GSD project status report?

Yes, you need a .planning directory and related files to generate a GSD project status report, because the tracking mechanism requires access to these specific project files to evaluate actual progress.

Can I use this project tracking method to update or modify my project files?

No, you cannot use this project tracking method to update or modify project files, because it operates as a read-only tool, with the sole exception of an optional fix to a stale STATE.md file.

What is the best way to find out what to do next in my project management workflow?

The best way to determine what to do next in your project management workflow is to analyze your current project state, which provides a primary next step recommendation along with alternative suggestions based on recent work.