GS

Get progress updates and integrity checks for your project.

Install

mkdir -p .claude/skills/gsd-progress && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12563" && unzip -o skill.zip -d .claude/skills/gsd-progress && rm skill.zip

Installs to .claude/skills/gsd-progress

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Check project progress, show context, and route to next action (execute or plan). Use --forensic to append a 6-check integrity audit after the standard report.
159 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Summarize recent work.
  • Summarize what's ahead in the project.
  • Route to the next action, either executing an existing plan or creating a new one.
  • Provide situational awareness before continuing work.
  • Append a 6-check integrity audit with the `--forensic` argument.

How it works

The skill executes a progress workflow that checks project status, summarizes recent and upcoming work, and then intelligently routes to the next action, which can be executing an existing plan or creating a new one.

Inputs & outputs

You give it
An optional `--forensic` argument.
You get back
A report on project progress, recent work, and upcoming tasks, with a suggested next action, and optionally a 6-check integrity audit.

When to use gsd-progress

  • Checking project status
  • Running integrity audits
  • Identifying next tasks

About this skill

<codex_skill_adapter>

A. Skill Invocation

  • This skill is invoked by mentioning $gsd-progress.
  • Treat all user text after $gsd-progress as {{GSD_ARGS}}.
  • If no arguments are present, treat {{GSD_ARGS}} as empty.

B. AskUserQuestion → request_user_input Mapping

GSD workflows use AskUserQuestion (Claude Code syntax). Translate to Codex request_user_input:

Parameter mapping:

  • headerheader
  • questionquestion
  • Options formatted as "Label" — description{label: "Label", description: "description"}
  • Generate id from header: lowercase, replace spaces with underscores

Batched calls:

  • AskUserQuestion([q1, q2]) → single request_user_input with multiple entries in questions[]

Multi-select workaround:

  • Codex has no multiSelect. Use sequential single-selects, or present a numbered freeform list asking the user to enter comma-separated numbers.

Execute mode fallback:

  • When request_user_input is rejected (Execute mode), present a plain-text numbered list and pick a reasonable default.

C. Task() → spawn_agent Mapping

GSD workflows use Task(...) (Claude Code syntax). Translate to Codex collaboration tools:

Direct mapping:

  • Task(subagent_type="X", prompt="Y")spawn_agent(agent_type="X", message="Y")
  • Task(model="...") → omit (Codex uses per-role config, not inline model selection)
  • fork_context: false by default — GSD agents load their own context via <files_to_read> blocks

Parallel fan-out:

  • Spawn multiple agents → collect agent IDs → wait(ids) for all to complete

Result parsing:

  • Look for structured markers in agent output: CHECKPOINT, PLAN COMPLETE, SUMMARY, etc.
  • close_agent(id) after collecting results from each agent </codex_skill_adapter>
<objective> Check project progress, summarize recent work and what's ahead, then intelligently route to the next action - either executing an existing plan or creating the next one.

Provides situational awareness before continuing work. </objective>

<execution_context> @/home/delorenj/code/bhappy/.codex/get-shit-done/workflows/progress.md </execution_context>

<process> Execute the progress workflow from @/home/delorenj/code/bhappy/.codex/get-shit-done/workflows/progress.md end-to-end. Preserve all routing logic (Routes A through F) and edge case handling. </process>

When not to use it

  • When the user wants to use multi-select for questions.

Limitations

  • It requires a workaround for multi-select questions.

How it compares

This skill provides automated situational awareness and intelligent routing to the next project action, which is more efficient and guided than manually determining project status and next steps.

Compared to similar skills

gsd-progress side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
gsd-progress (this skill)03moNo flagsIntermediate
keel-drift04moNo flagsIntermediate
cto-engineering-metrics510moNo flagsAdvanced
summarize-activity66moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry