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

MITAuto-check: notesProduct & Project Management

Install Ghm Gate Check

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

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

GitHub CLI
$ gh skill install mattgierhart/PRD-driven-context-engineering ghm-gate-check --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-gate-check .claude/skills/ghm-gate-check && 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-gate-check
GitHub stars
180
Token cost
~1.3k tokens
SKILL.md length
471 words
Files
4 (incl. references, assets)
Skills in repo
45
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 4 steps: Compute → Read → Report → …
  • Before advancing from v0.X to v0.Y
  • SKILL.md covers Workflow Overview, Authority, Step 1: Compute and Step 2: Read, plus 7 more sections
  • Calls python

What it does

Ghm Gate Check is an agent skill from mattgierhart/PRD-driven-context-engineering. Validates gate criteria before PRD lifecycle advancement by delegating to the readiness scoring pipeline (scripts/readiness.py). Returns a graduated PASS / WARN / BLOCK verdict with top blockers and their causal chain. Triggers before advancing from v0.X to v0.Y or explicit /ghm-gate-check.

Its SKILL.md is about 1.3k 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/gate-checklist-template.md`, `references/examples.md` and `references/gate-criteria.md`).

It sits in Product & Project Management, covering 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

  • Before advancing from v0.X to v0.Y
  • Explicit /ghm-gate-check

Example prompts

  • “Use the ghm-gate-check skill to validate gate criteria before PRD lifecycle advancement by delegating to the readiness scoring pipeline…”
  • “/ghm-gate-check”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash, Read, Glob, Grep

Workflow steps

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

  1. Compute
  2. Read
  3. Report
  4. Recommend

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:

    • Bash
    • Read
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    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 Gate Check loads about 1.3k tokens when it runs, and up to ~6.9k if it reads all its reference files. Until then it costs about 77 tokens; SKILL.md has 471 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Glob, Grep

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). 471 words, ~1,336 tokens.

Download SKILL.mdSave it as .claude/skills/ghm-gate-check/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
ghm-gate-check
description
Validates gate criteria before PRD lifecycle advancement by delegating to the readiness scoring pipeline (scripts/readiness.py). Returns a graduated PASS / WARN / BLOCK verdict with top blockers and their causal chain. Triggers before advancing from v0.X to v0.Y or explicit `/ghm-gate-check`.
allowed-tools
Bash, Read, Glob, Grep
context
inline

Gate Check

Validate whether the PRD stage is ready to advance to the next version. Delegates to the three-layer readiness scorer — SoT files → EPICs → stage — then surfaces the leverage view (what to fix first, and which EPICs it unblocks).

Workflow Overview

  1. Compute → run scripts/readiness.py run --quiet to refresh status/readiness.json
  2. Read → parse status/readiness.json
  3. Report → PASS / WARN / BLOCK verdict with top blockers and causal links
  4. Recommend → actionable next steps (always highest-leverage first)

Authority

references/gate-criteria.md remains the canonical source of mandatory artifacts per gate. The scorer's GATE_REQUIREMENTS table mirrors it. Do not hand-roll checklists here — the scoring engine is the single source of truth.

Step 1: Compute

Run the orchestrator. It runs SoT → EPIC → stage in dependency order and writes status/readiness.json.

bash
python scripts/readiness.py run --quiet
# exit 0 = all pass, 1 = warn, 2 = block, 3 = error

If the exit code is 3, report a runtime error and stop. If 0/1/2, proceed to Step 2.

Fallback: no scripts available

If scripts/readiness.py is missing or Python is unavailable, fall back to reading status/readiness.json directly. If that's also absent, report: "Readiness not yet computed — install scripts/requirements.txt and run python scripts/readiness.py run."

Step 2: Read

bash
cat status/readiness.json

Extract:

  • summary.current_stage — the gate being evaluated and its score
  • summary.top_blockers — ranked SoT files blocking progress
  • stages.{target} — detailed stage block (dimensions, unmet_criteria, caps)
  • epics.{id} — per-EPIC scores (cite the lowest ones)

Step 3: Report

Use this template. Fill every field from the JSON — do not improvise scores.

markdown
## Gate Check Report: {stage.gate_description}

**Verdict**: [PASS | WARN | BLOCK]
**Stage Score**: {stage.score} / 100  (warn < {threshold_warn}, block < {threshold_block})
**Date**: {now}

### Stage Dimensions

| Dimension | Score | Weight |
|-----------|-------|--------|
| required_ids_present | {score} | {weight} |
| relevant_sot_readiness | {score} | {weight} |
| cross_ref_integrity | {score} | {weight} |
| downstream_epic_readiness | {score or "n/a"} | {weight or "—"} |

### Top Blockers (leverage view)

1. **{file}** (score {score}) — blocks {N} EPICs: {EPIC-XX, …} — impact {impact}
2. …

### Unmet Criteria (high severity first)

- [high] {ref}: {reason}
- [medium] {ref}: {reason}

### Recommendation

**If PASS**: Advance to {next_version}. Run `ghm-status-sync` to update the README dashboard.

**If WARN / BLOCK**: Do not advance. Address top blockers in order — fixing the highest-impact SoT file cascades up the graph.

**Next action**: {top_blockers[0] → concrete fix}
Verdict bands
Stage scoreVerdictMeaning
≥ 70PASSSafe to advance
50–69WARNAdvance with documented risk; log in PRD change log
< 50BLOCKCannot advance — per rule 05-lifecycle-gates, update the EPIC and STOP

Step 4: Recommend

Always prioritize by impact = (100 − score) × #EPICs blocked. The top blocker is the single highest-leverage fix; cite its blocking_epics list so the human understands what unblocks.

Show full SKILL.md (186 more words)Show less

Quality Gates

  • Stage score cited from JSON, not estimated
  • Top blockers include their consumer EPICs
  • Recommendation is actionable (specific file, specific action)
  • Verdict matches the score band exactly (don't round up)

Anti-Patterns

PatternExampleFix
Ignoring the score"Feels ready; pass"Cite stage.score verbatim
Skipping blockers"Minor stuff, advance anyway"Block if score < 50; warn if < 70
Hand-rolling criteriaRe-checking IDs manuallyTrust the scorer; if wrong, fix GATE_REQUIREMENTS in _readiness/stage.py
Forcing PASSOverriding the verdictNever override; the score is the contract

Boundaries

DO:

  • Delegate computation to readiness.py
  • Cite specific scores, files, and EPICs from the JSON
  • Surface the top_blockers leverage view

DON'T:

  • Modify status/readiness.json directly — it's computed output
  • Create missing artifacts inside this skill (that's the author's job)
  • Override PASS/BLOCK verdicts subjectively

Handoff

After a report:

  • PASS: Trigger ghm-status-sync; the gate advancement updates the README dashboard
  • WARN: Same as PASS but note the risks in the PRD change log
  • BLOCK: Return control to the human. The top_blockers[0] fix is the single most important next action

References

  • references/gate-criteria.md — canonical gate requirements (consumed by scorer)
  • references/examples.md — pass/warn/block report examples
  • .claude/rules/07-readiness-protocol.md — the discipline rule
  • docs/READINESS_PROTOCOL.md — full schema

© 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-gate-check of mattgierhart/PRD-driven-context-engineering.

  • SKILL.md
  • assets/gate-checklist-template.md
  • references/examples.md
  • references/gate-criteria.md

Open the folder on GitHubat commit 30ed1b0

Compare with similar skills

Ghm Gate Check 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 Gate Check compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ghm Gate Check this skillmattgierhart/PRD-driven-context-engineering180—~1.3kAutomated safety check: NotesMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Trellis Brainstormanjiemo/SunnyBeach1787 repos~4kAutomated safety check: PassApache-2.0
Ralph Tui Create Beads Rustsubsy/ralph-tui2.5k1 repos~2.8kAutomated safety check: PassMIT
Ralph Tui Create JSONsubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT

Similar skills

  • 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
  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Trellis Brainstorm

    anjiemo/SunnyBeach

    Guides collaborative requirements discovery before implementation.

    178 GitHub starsUsed in 7 repos~4k tokens
    Product & Project ManagementAuto-check passed
  • Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).

    2.5k GitHub starsUsed in 1 repo~2.8k tokens
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create JSON

    subsy/ralph-tui

    Convert PRDs to prd.json format for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Prd Generator

    jamesrochabrun/skills

    Generate comprehensive Product Requirements Documents (PRDs) for product managers.

    216 GitHub starsUsed in 2 repos~3.8k tokens
    Product & Project ManagementAuto-check passed

More from mattgierhart/PRD-driven-context-engineering

All 45 skills in this repo
  • 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
  • Prd V02 Competitive Landscape Mapping

    mattgierhart/PRD-driven-context-engineering

    Map the competitive landscape before positioning your product for PRD v0.2 Market Definition.

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

Questions about Ghm Gate Check

What does Ghm Gate Check do?

Validates gate criteria before PRD lifecycle advancement by delegating to the readiness scoring pipeline (scripts/readiness.py). Ghm Gate Check is an agent skill from mattgierhart/PRD-driven-context-engineering.py).

When should I use Ghm Gate Check?

Ghm Gate Check fits situations like: before advancing from v0.X to v0.Y; explicit /ghm-gate-check.

How do I install Ghm Gate Check in Claude Code?

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

How do I install Ghm Gate Check in Codex?

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

Can I use Ghm Gate Check 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-gate-check -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-gate-check, .gemini/skills/ghm-gate-check, .github/skills/ghm-gate-check and .opencode/skills/ghm-gate-check in your project.

What does Ghm Gate Check need to run?

Going by SKILL.md and its folder, Ghm Gate Check needs the command-line tools its instructions call (python). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash, Read, Glob, Grep.

Does Ghm Gate Check 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 Gate Check safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Ghm Gate Check use?

Ghm Gate Check 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 Gate Check use?

About 1.3k tokens (SKILL.md is roughly 5.3k 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 5.6k tokens, read only when the agent opens those files.

What are the alternatives to Ghm Gate Check?

Skills that share tags, products or a category with Ghm Gate Check: CCPM Project Management (automazeio/ccpm, 8.4k stars), Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Trellis Brainstorm (anjiemo/SunnyBeach, 178 stars) and Ralph Tui Create Beads Rust (subsy/ralph-tui, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ghm Gate Check?

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.