Synchronizes README.md Command Center with current project state.

MITAuto-check passedProduct & Project Management

Install Ghm Status Sync

skills CLI
$ npx skills add mattgierhart/PRD-driven-context-engineering --skill ghm-status-sync -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mattgierhart/PRD-driven-context-engineering ghm-status-sync --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mattgierhart/PRD-driven-context-engineering.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/ghm-status-sync .claude/skills/ghm-status-sync && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ghm-status-sync
GitHub stars
180
Token cost
~920 tokens
SKILL.md length
413 words
Files
4 (incl. references, assets)
Skills in repo
45
Repo updated
First seen
Licence
MIT

At a glance

Synchronizes README.md Command Center with current project state.

  • Works in 3 steps: Load Context → Extract Current State → Update README Dashboard
  • EPIC status changes
  • SKILL.md covers Workflow Overview, Core Output Template, Step 1: Load Context and Step 2: Extract Current State, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Ghm Status Sync is an agent skill from mattgierhart/PRD-driven-context-engineering. Synchronizes README.md Command Center with current project state. Triggers on gate changes, EPIC status changes, or explicit /ghm-status-sync invocation. Outputs updated README.md dashboard with current lifecycle stage, blockers, and metrics.

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files and assets (for example `assets/status-sync-template.md`, `references/examples.md` and `references/sync-triggers.md`).

It sits in Product & Project Management, covering Technical documentation and PRD writing. The repository describes itself as: PRD-Led Context Engineering — Memory as Infrastructure. An ontology layer for product teams building products that solve real problems — with AI agents that remember. Gated PRD… The licence is MIT.

When your agent uses it

  • EPIC status changes
  • Explicit /ghm-status-sync invocation

Example prompts

  • “Use the ghm-status-sync skill to synchroniz README.md Command Center with current project state”
  • “/ghm-status-sync”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, Glob, Grep

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Load Context
  2. Extract Current State
  3. Update README Dashboard

What it can do on your machine

Read from SKILL.md and the folder at commit 30ed1b0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ghm Status Sync loads about 920 tokens when it runs, and up to ~3.5k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 413 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~920
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mattgierhart/PRD-driven-context-engineering at commit 30ed1b0, republished under its MIT licence (© mattgierhart). 413 words, ~920 tokens.

Download SKILL.mdSave it as .claude/skills/ghm-status-sync/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
ghm-status-sync
description
Synchronizes README.md Command Center with current project state. Triggers on gate changes, EPIC status changes, or explicit `/ghm-status-sync` invocation. Outputs updated README.md dashboard with current lifecycle stage, blockers, and metrics.
allowed-tools
Read, Write, Edit, Glob, Grep
context
inline

Status Sync

Synchronize the README.md Command Center with the current project state after gate advancement or EPIC status changes.

Workflow Overview

  1. Load Context → Read README.md, PRD.md metadata, Active EPIC Session State section
  2. Extract State → Pull lifecycle stage, blockers, metrics
  3. Update Dashboard → Sync README sections with current truth

Core Output Template

ElementDefinitionEvidence
Lifecycle StageCurrent PRD version from PRD.mdCurrent Lifecycle Gate: v0.X
Gate StatusVisual progress indicators🟢 Complete / 🟡 In Progress / ⚪ Pending
Active EPICCurrent work from EPIC headerEPIC-XX: Title
BlockersOpen blockers from EPIC Session State sectionList with severity

Step 1: Load Context

Read these files in order:

  1. README.md (current state)
  2. PRD.md (metadata block for lifecycle stage)
  3. Active EPIC Session State section (blockers, progress)
Checklist
  • README.md loaded
  • PRD.md metadata extracted
  • Active EPIC identified and Session State section read

Step 2: Extract Current State

Pull authoritative values:

FieldSource
Lifecycle StagePRD.md Current Lifecycle Gate
Gate ProgressPRD.md gate table
Active EPICREADME.md Active Work section
BlockersEPIC Session State section
MetricsREADME.md Truth Table

Step 3: Update README Dashboard

Apply synchronization rules:

  1. Lifecycle Stage: Update header to match PRD.md
  2. Gate Table:
    • 🟢 = Passed gates (all criteria met)
    • 🟡 = Current gate (in progress)
    • ⚪ = Future gates (not started)
  3. Active EPIC: Update metadata in Active Work section
  4. Blockers: Sync from EPIC Session State section
  5. Squad Status (Section: squad-status): Update agent and EPIC tables:
    • For each agent in .claude/agents/: check MEMORY.md mtime for "Last Active", grep EPICs for agent name for "Current EPIC"
    • For each EPIC in epics/: read State field, Epic Lead, and Change Log last date
    • Status values: active (session <2h old), idle (no recent activity), blocked (blocker in session state)
Show full SKILL.md (131 more words)Show less

Quality Gates

Pass Checklist
  • README lifecycle stage matches PRD.md
  • Gate indicators are accurate (no 🟢 on incomplete gates)
  • Active EPIC reference is current
  • Blockers reflect actual state
Testability Check
  • Can be validated by comparing README to PRD.md
  • Gate status is traceable to gate criteria

Anti-Patterns

PatternExampleFix
Stale gate status🟢 on gate with missing criteria→ Verify all criteria before marking complete
Missing blockersEPIC has blockers, README shows none→ Always sync from EPIC Session State section
Wrong EPIC referenceREADME points to closed EPIC→ Check EPIC status before updating

Boundaries

DO:

  • Status synchronization
  • Link updates
  • Gate progression indicators

DON'T:

  • Content changes to descriptions
  • Create new sections
  • Modify PRD.md (read-only source)

Handoff

After status sync completes:

  • README.md is current and accurate
  • Ready for next work session
  • Gate-check skill can validate if advancing

© mattgierhart, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references, assets) in .claude/skills/ghm-status-sync of mattgierhart/PRD-driven-context-engineering.

  • SKILL.md
  • assets/status-sync-template.md
  • references/examples.md
  • references/sync-triggers.md

Open the folder on GitHubat commit 30ed1b0

Compare with similar skills

Ghm Status Sync next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ghm Status Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ghm Status Sync this skillmattgierhart/PRD-driven-context-engineering180—~920Automated safety check: PassMIT
Project Planneradrianpuiu/claude-skills-marketplace1001 repos~6kAutomated safety check: PassNone
Code to PRDalirezarezvani/claude-skills28k1 repos~4.9kAutomated safety check: PassMIT
Hai Audit Docshylarucoder/hai-stack386—~1.1kAutomated safety check: PassCustom licence
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Reviewfossasia/eventyay-interpretation1.6k35 repos~996Automated safety check: PassApache-2.0

Similar skills

  • Project Planner

    adrianpuiu/claude-skills-marketplace

    Comprehensive project planning and documentation generator for software projects.

    100 GitHub starsUsed in 1 repo~6k tokens
    Product & Project ManagementAuto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Product & Project ManagementAuto-check passed
  • Hai Audit Docs

    hylarucoder/hai-stack

    Audits documentation for internal contradictions and/or mismatches with code, config, schemas, and approved contracts.

    386 GitHub stars~1.1k tokensUpdated 6 days ago
    Product & Project ManagementAuto-check passed
  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Review

    fossasia/eventyay-interpretation

    Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match…

    1.6k GitHub starsUsed in 35 repos~996 tokens
    Product & Project ManagementAuto-check passed
  • Grilling Ideas

    opsmill/infrahub

    Stress-tests a fuzzy or vague feature idea before any PRD, spec, or ticket is written.

    534 GitHub stars~3.8k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from mattgierhart/PRD-driven-context-engineering

All 45 skills in this repo
  • Ghm Gate Check

    mattgierhart/PRD-driven-context-engineering

    Validates gate criteria before PRD lifecycle advancement by delegating to the readiness scoring pipeline (scripts/readiness.py).

    180 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check: notes
  • Ghm Harvest

    mattgierhart/PRD-driven-context-engineering

    Extracts durable insights from temp/ files to SoT during EPIC Phase E.

    180 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Ghm Id Register

    mattgierhart/PRD-driven-context-engineering

    Validates and registers new SoT IDs with cross-reference integrity.

    180 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Ghm Sot Builder

    mattgierhart/PRD-driven-context-engineering

    Creates new Source of Truth (SoT) files when existing templates don't fit your needs.

    180 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check passed
  • Prd V01 Problem Framing

    mattgierhart/PRD-driven-context-engineering

    Transform vague product ideas into evidence-anchored problem statements for PRD v0.1 Spark.

    180 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Prd V01 User Value Articulation

    mattgierhart/PRD-driven-context-engineering

    Transform validated pain points into articulated user value statements for PRD v0.1 Spark.

    180 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Ghm Status Sync

What does Ghm Status Sync do?

Synchronizes README.md Command Center with current project state. Ghm Status Sync is an agent skill from mattgierhart/PRD-driven-context-engineering.md Command Center with current project state.

When should I use Ghm Status Sync?

Ghm Status Sync fits situations like: EPIC status changes; explicit /ghm-status-sync invocation.

How do I install Ghm Status Sync in Claude Code?

Run `npx skills add mattgierhart/PRD-driven-context-engineering --skill ghm-status-sync -a claude-code`. Or copy the skill folder (.claude/skills/ghm-status-sync in mattgierhart/PRD-driven-context-engineering) into .claude/skills/ghm-status-sync in your project. Claude Code loads it when a task matches its description.

How do I install Ghm Status Sync in Codex?

Run `npx skills add mattgierhart/PRD-driven-context-engineering --skill ghm-status-sync -a codex`. Or copy the skill folder (.claude/skills/ghm-status-sync in mattgierhart/PRD-driven-context-engineering) into .agents/skills/ghm-status-sync in your project. Codex loads it when a task matches its description.

Can I use Ghm Status Sync in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mattgierhart/PRD-driven-context-engineering --skill ghm-status-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ghm-status-sync, .gemini/skills/ghm-status-sync, .github/skills/ghm-status-sync and .opencode/skills/ghm-status-sync in your project.

What does Ghm Status Sync need to run?

SKILL.md names no scripts, command-line tools or credentials: Ghm Status Sync is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Glob, Grep.

Does Ghm Status Sync access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ghm Status Sync safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ghm Status Sync use?

Ghm Status Sync is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ghm Status Sync use?

About 920 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.6k tokens, read only when the agent opens those files.

What are the alternatives to Ghm Status Sync?

Skills that share tags, products or a category with Ghm Status Sync: Project Planner (adrianpuiu/claude-skills-marketplace, 100 stars), Code to PRD (alirezarezvani/claude-skills, 28k stars), Hai Audit Docs (hylarucoder/hai-stack, 386 stars) and CCPM Project Management (automazeio/ccpm, 8.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ghm Status Sync?

mattgierhart (a GitHub user) maintains it in mattgierhart/PRD-driven-context-engineering, which has 180 GitHub stars. The repository holds 45 skills in this directory. The repository was last updated on August 31, 2026.

Source: mattgierhart/PRD-driven-context-engineering on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.