Goal Governor

Use when a Codex goal/task is stuck, hanging, not finishing, or needs status. Reads goal.md, state.yaml, receipts.jsonl; syncs reported status with board files; fixes invalid state.yaml; classifies blockers; decides done. Not for ordinary reviews or one-off fixes.

9 stars 4 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jscraik/Agent-Skills --skill goal-governor
Manual install
git clone --depth 1 https://github.com/jscraik/Agent-Skills.git /tmp/Agent-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Agent-Skills/Skills/agent-ops/goal-governor ~/.claude/skills/goal-governor

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Goal Governor

## When To Use

Use only for durable Codex goal work that has, or needs, a repo-visible board.
Use it to create, continue, doctor, check, repair, import, or review a governed
goal. Do not use it for ordinary code review, uncommitted-change review, a
one-file fix, or any request without a goal board, `/goal`, native goal runtime,
or Goal Governor mode. For an ordinary review, do not write
`goal-governor-output.yaml` or emit `native_goal_status`/`goal_path`; return the
request to the normal review flow with `PROMPT_REVIEW_ONLY`.

Classify “check this prompt” or “not start yet” as `review` unless the user also
says `proceed with governed implementation`. Classify a new durable goal as
`create`, an existing/stalled board as `continue`, runtime readiness as `doctor`,
validator-only work as `check`, board drift as `repair`, and source material
becoming a board as `import`.

## Inputs

- Project instructions plus a goal prompt or selected board path.
- For create/import: objective, editable boundary, verification command, and
  stop condition.
- For continuation/closeout: `goal.md`, `state.yaml`, `receipts.jsonl`, native
  goal state when available, and the current completion contract.

When the goal request is underspecified and interaction is available, ask one
plain-language discovery question at a time. In a no-tool or file-visible
evaluation, persist `mode: discovery`, `Round 1 question`, `What should this
Read the full skill on GitHub

Details

Skill name
goal-governor
Path
Skills/agent-ops/goal-governor/SKILL.md
License
Apache-2.0
Repo updated
16 November 2026

FAQ

What does the Goal Governor skill do?

Use when a Codex goal/task is stuck, hanging, not finishing, or needs status. Reads goal.md, state.yaml, receipts.jsonl; syncs reported status with board files; fixes invalid state.yaml; classifies blockers; decides done. Not for ordinary reviews or one-off fixes.

How do I install the Goal Governor skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jscraik/Agent-Skills --skill goal-governor. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Goal Governor popular?

It lives in jscraik/Agent-Skills, which has 9 GitHub stars and 4 forks.

Related skills

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.