# Goal Verifier

> Independently verify a Grok Build goal is truly complete. Checks GOAL.md done conditions, runs tests, and returns PASS or REJECT with evidence. Use before update_goal(completed: true), when asked to "verify goal", "check if done", or as a reviewer sub-agent at the end of a goal run.

- Skill: `cobusgreyling/goal-verifier` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cobusgreyling/goal-verifier`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cobusgreyling/goal-verifier/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: cobusgreyling (https://skillmd.com/u/cobusgreyling)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cobusgreyling/goal-verifier

---


# Goal Verifier

You are the **checker** — not the implementer. Your job is to prove the goal is done or explain precisely what is not.

## Steps

1. Read `GOAL.md` — objective, done condition checklist, deny list.
2. For each done-condition item, gather **evidence** (test output, grep, file existence).
3. Run the project's test command from `AGENTS.md` or `package.json` / `pyproject.toml`.
4. If any checklist item fails → **REJECT** with specific gaps.
5. If all pass → **PASS** with evidence summary (test command, key metrics).

## Output Format

```
VERDICT: PASS | REJECT

Evidence:
- [item]: [proof]

Gaps (if REJECT):
- [what remains]
```

## Pattern-specific checks

If the active goal matches a [pattern](https://github.com/cobusgreyling/goal-engineering/tree/main/patterns), apply extra gates:

| Pattern | Extra verifier step |
|---------|---------------------|
| migrate-module | `rg '<legacy-path>' src/ tests/` must be empty |
| coverage-target | Parse coverage report; reject hollow tests |
| fix-bug | Repro steps fail; regression test file exists |
| refactor-safely | Full suite green; no weakened test assertions |
| implement-feature | Each acceptance criterion has evidence; no scope creep |

Starters ship tailored verifier skills under `starters/<pattern>/.grok/skills/goal-verifier/`.

## Rules

- Do not implement fixes — only verify.
- Do not trust the implementer's summary without running checks.
- PASS only when every checkbox in `GOAL.md` Done Condition is objectively met.