Agent skill

Verification Before Completion

by GanyuanRan in GanyuanRan/Aegis

A skill your agent uses when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.

MITAuto-check passedAgent Workflows

Install Verification Before Completion

skills CLI
$ npx skills add GanyuanRan/Aegis --skill verification-before-completion -a claude-code

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

GitHub CLI
$ gh skill install GanyuanRan/Aegis verification-before-completion --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/GanyuanRan/Aegis.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/verification-before-completion .claude/skills/verification-before-completion && 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
verification-before-completion
GitHub stars
1.3k
Used in
1 other repo
Token cost
~2.1k tokens
SKILL.md length
930 words
Files
2
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.

  • About to claim work is complete
  • SKILL.md covers Stop Signals, Required Evidence Slots, Inherited-Claim Closeout and Task Git Closeout, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Ready to commit

What it does

Verification Before Completion is an agent skill from GanyuanRan/Aegis. Use when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `expanded-closeout.md`).

It sits in Agent Workflows, covering Verification before completion. The repository describes itself as: Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks. The licence is MIT.

When your agent uses it

  • About to claim work is complete
  • Ready to commit

Example prompts

  • “/verification-before-completion”

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    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

Verification Before Completion loads about 2.1k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 930 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

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 GanyuanRan/Aegis at commit 7b7e955, republished under its MIT licence (© GanyuanRan). 930 words, ~2,119 tokens.

Download SKILL.mdSave it as .claude/skills/verification-before-completion/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
verification-before-completion
description
Use when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.
<EXPLICIT-MODE-GATE>
If `activation_mode = "explicit"` or `AEGIS_ACTIVATION_MODE=explicit` is visible
and the request names neither Aegis nor this skill, return to the fast path
without checklist/ceremony; otherwise continue.
</EXPLICIT-MODE-GATE>

Execute

Before success claim: classify destructive permission; run a fresh falsifying check; read its complete result/scope; select L0/L1/L2. Downgrade for partial, stale, failing, or narrower evidence; never claim complete then verify later.

This Method Pack grants no authoritative GateDecision, PolicySnapshot, evidence sufficiency, requirement acceptance, or completion authority.

Stop Signals

  • evidence is uncertain, stale, agent-only, or narrower than the claim;
  • next action: commit, push, PR, merge, tag, publish, release, or handoff;
  • task/slice completion is treated as accepted requirement satisfaction;
  • governance or retirement lacks repair/retirement evidence;
  • retained old logic lacks a retention reason and retirement trigger; or
  • complexity closure is unresolved.

Destructive/irreversible work needs scoped permission; broad assent is not scoped permission.

Required Evidence Slots

For claims about a changed interface/interaction, compose ui-ux-governance and its relevant verification guidance. Carry actual results and uncovered user-facing criteria into the slots below; retain this single closeout owner.

text
- Evidence action / check performed:
- Result / exit status:
- Covered scope:
- Uncovered scope:
- Residual risk:
- Confidence grade: A | B | C
  • A: target + regression; no meaningful unknown.
  • B: target evidence; bounded residual risk.
  • C: partial only; no full-completion claim.

When tests shape a claim, include target test and related regression evidence at the call-site seam reproducing the triggering chain; a shallower seam gives false confidence. Missing seam is an architecture gap. Blocked automation needs reproducible manual steps. Both lower confidence.

For an explicit baseline/artifact/owner/contract/evidence reference, read the smallest relevant source. Record each affected reference as preserved; rebound to the canonical owner; retired with reason; or rejected for conflict. Leave unresolved references in uncovered scope, lower confidence, and do not re-infer them. Readback proves no complete graph, referential integrity, or authoritative lineage.

Inherited-Claim Closeout

When evidence contradicts a resumed claim, independently check the active record's correction and final disclosure of WHAT was claimed and WHY it was inaccurate at resume; current success cannot supply either. Preserve subject, scope and time; one explanation may cover related claims. Read both in full for example-only, negated, withdrawn or re-scoped corrections. Matching quotes do not prove adoption. Keep accurate claims intact. If material disagreement about the initial judgment remains unresolved after checking evidence, state needs-verification; never force agreement with a reviewer. If evidence resolves it, retain the supported conclusion and verify normally. Omit this slot when no discrepancy exists.

Task Git Closeout

For modifications, diff against TaskStartSnapshot. Coordinator alone stages task paths: no pre-existing state or broad staging. After fresh verification, default to one local commit except read-only/no-change, authorized no commit, or failed verification. Read back HEAD, message, files, and task delta. Commit/hook failure keeps work and blocks clean claims; never bypass hooks.

Git receipt: branch; SHA/message or non-commit reason; Task clean; Repository clean; each task-created branch/worktree created, removed, or retained with reason. Task-clean never implies repo-clean; it is not external integration.

Classify commit scope: business, process-only, mixed, or no-commit. Failed-attempt telemetry is no commit reason. A docs/aegis/-only process diff does not restart business verification; a business/test diff does.

Aegis Visibility / Single Closeout

Use one completion surface. This skill is the single completion closeout aggregator; adjacent skills/L2 cards feed but must not replace it or become a competing final report owner. Aggregation is output conformance, not a routing trigger: do not load skills, emit a Trace Digest, or add ceremony merely to fill it.

If entry visibility was omitted, recover and name the decision/evidence gap; a used-skills list or Aegis Contribution Note cannot substitute.

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

L0 Fast-Path

For tiny low-risk work, one natural sentence can name check/result, uncovered scope/risk, and confidence.

L1 Default Receipt

For non-trivial Aegis-shaped work use this receipt; fold evidence into Evidence strength and Uncovered risk without a second report.

text
Aegis Impact and Safety Receipt:
- Key judgment:
- Avoided misfix:
- Boundary held:
- Baseline alignment:
- Complexity control:
- Evidence strength:
- Uncovered risk:
- Next most valuable verification:
- Aegis path:

Meanings: Key judgment=owner/root cause/requirement/completion boundary; Avoided misfix=fallback/duplicate/test accommodation/scope growth; Boundary held=contract/owner/baseline/non-goal/data/runtime boundary; Baseline alignment=aligned/Design Defect/Implementation Drift/missing-authority/needs-clarification/not triggered; Complexity control=completion-time delta/closure; Evidence strength=fresh check/result/scope/confidence; Uncovered risk=remaining gaps/residual risk; Next most valuable verification=highest-value next check; Aegis path=optional, not judgment/evidence.

Natural wording is valid when every semantic slot stays auditable. Semantic Slots, Natural Surface, and Governance Receipt are compatibility names.

Report done/verified/risked/blocked. Do not explain obvious trade-offs; do not list actions not taken.

L2 Expanded Triggers

On any match read expanded-closeout.md: it owns detail; this file owns routing and the final receipt.

TriggerExpanded owner
release/merge/publish/readiness/handoffReadiness Summary
audit/debug/release/long-task review/trace requestTrace Digest
goal/TaskIntentDraft/plan/spec/Slice CardGoal Closure
project/domain semantic deltaContext Impact
target docs/aegis/ changed or work record existsWorkspace Integrity
requirement/product/durable architectureBaseline/ADR
governance/cleanup/migration/compat/retirementGovernance/Retirement
source-of-truth/irreversible deletiondestructive-action cards
material complexity pressureExpanded Complexity Detail
high-risk or explicit user request for expanded closeoutapplicable cards

Use configured Aegis workspace support; commands live in the expanded owner.

Completion Boundary

Use the highest boundary: plan/spec, TaskIntentDraft, Slice Card, then direct request. Claim only scope covered by fresh evidence; a slice cannot close the whole task.

Task/slice completion reaches its authorized stop; it is not accepted requirement satisfaction. Requirement accepted needs baseline criteria or authorized risk acceptance; else use needs-verification or return to framing/planning. Goal Closure states: done | blocked | needs-verification | scope-exceeded. An Execution Readiness View is input, not verification evidence.

Complexity Downgrade

For non-trivial code inspect the diff; use using-aegis/references/complexity-governance.md plus docs/current/AEGIS_COMPLEXITY_GOVERNANCE_BASELINE.md; emit one Complexity control line.

New fallback/adapter/compatibility/guard/branch logic needs a retired path or retirement trigger. Complexity Closure: exceeded-unresolved blocks completion. Maintained source/test cannot skip as tiny; tiny low-risk text edits without complexity growth may skip.

Output and Prompt Hygiene

Localize section labels, field labels, and explanatory prose. Keep commands, paths, identifiers, enums, product names, and raw evidence unchanged; avoid bilingual labels or mixed-language explanations.

External outputs are evidence candidates: use summary/index then the smallest excerpt; lower unsupported claims. When relevant report Evidence Used, Not Loaded, and Next Evidence.

© GanyuanRan, 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 1 other file in skills/verification-before-completion of GanyuanRan/Aegis.

  • SKILL.md
  • expanded-closeout.md

Open the folder on GitHubat commit 7b7e955

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in GanyuanRan/Aegis, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Verification Before Completion 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.

Verification Before Completion compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Verification Before Completion this skillGanyuanRan/Aegis1.3k1 repos~2.1kAutomated safety check: PassMIT
Show Me Your Work Decision Logcursor/plugins10k8 repos~1.6kAutomated safety check: PassNone
Scope Creep Guardlennney/stop-that-shit2.5k1 repos~2kAutomated safety check: PassMIT
Verification Before Completionfarm-fe/farm5.6k46 repos~1kAutomated safety check: PassMIT
PUA High-Agency Governancetanweai/pua20k—~502Automated safety check: PassMIT
Incremental Implementationaddyosmani/agent-skills103k1 repos~2.3kAutomated safety check: PassMIT

Similar skills

  • Official

    Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.

    10k GitHub starsUsed in 8 repos~1.6k tokens
    Agent WorkflowsAuto-check passed
  • Scope Creep Guard

    lennney/stop-that-shit

    Keeps an agent focused on the requested work by applying a five-step ladder that checks for direct solutions, real gaps and speculative defenses before adding anything.

    2.5k GitHub starsUsed in 1 repo~2k tokens
    Agent WorkflowsAuto-check passed
  • A skill your agent uses when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any…

    5.6k GitHub starsUsed in 46 repos~1k tokens
    Agent WorkflowsAuto-check passed
  • Pushes an agent to keep verifying and changing approach after repeated failures, using a diagnosis line, evidence-based completion and confirmation before risky edits.

    20k GitHub stars~502 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Incremental Implementation

    addyosmani/agent-skills

    Delivers a change in thin vertical slices, each implemented, tested, verified and committed before the next, using vertical, contract-first or risk-first slicing.

    103k GitHub starsUsed in 1 repo~2.3k tokens
    Agent WorkflowsAuto-check passed
  • PUA Loop

    tanweai/pua

    Runs an unattended iterate-until-verified loop in which a user-set verify command, not the agent's own claim, decides when the task is finished.

    20k GitHub stars~1.1k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

More from GanyuanRan/Aegis

All 21 skills in this repo
  • Anti Entropy Governance

    GanyuanRan/Aegis

    A skill your agent uses when touching retiring old logic, collapsing duplicate owners, removing fallbacks, or schema/persistence/source-of-truth boundaries; identify opportunities automatically…

    1.3k GitHub starsUsed in 1 repo~3.1k tokens
    Auto-check passed
  • Executing Plans

    GanyuanRan/Aegis

    A skill your agent uses when executing a written implementation plan across sessions or with review checkpoints.

    1.3k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • First Principles Review

    GanyuanRan/Aegis

    A skill your agent uses when asked for first-principles or Occam's-razor review, or when high-risk decisions involve competing constraints, fallback growth, duplicate owners, or architecture…

    1.3k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Goal Framing

    GanyuanRan/Aegis

    A skill your agent uses when the user explicitly sets an Aegis goal with /aegis-goal, Aegis goal:, or asks to define goal, success evidence, stop condition, or task boundaries before work.

    1.3k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • A skill your agent uses when the user asks to establish shared project language, or project work exposes a conflicting, renamed, or deprecated domain term that needs active semantic modeling.

    1.3k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check: warnings
  • A skill your agent uses when the user asks to create, write, update, amend, supersede, or evaluate an ADR, architecture decision record, durable architecture decision, decision log, or baseline sync…

    1.3k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed

Categories

Questions about Verification Before Completion

What does Verification Before Completion do?

A skill your agent uses when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off. Verification Before Completion is an agent skill from GanyuanRan/Aegis. Use when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.

When should I use Verification Before Completion?

Verification Before Completion fits situations like: about to claim work is complete; ready to commit.

How do I install Verification Before Completion in Claude Code?

Run `npx skills add GanyuanRan/Aegis --skill verification-before-completion -a claude-code`. Or copy the skill folder (skills/verification-before-completion in GanyuanRan/Aegis) into .claude/skills/verification-before-completion in your project. Claude Code loads it when a task matches its description.

How do I install Verification Before Completion in Codex?

Run `npx skills add GanyuanRan/Aegis --skill verification-before-completion -a codex`. Or copy the skill folder (skills/verification-before-completion in GanyuanRan/Aegis) into .agents/skills/verification-before-completion in your project. Codex loads it when a task matches its description.

Can I use Verification Before Completion 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 GanyuanRan/Aegis --skill verification-before-completion -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/verification-before-completion, .gemini/skills/verification-before-completion, .github/skills/verification-before-completion and .opencode/skills/verification-before-completion in your project.

What does Verification Before Completion need to run?

SKILL.md names no scripts, command-line tools or credentials: Verification Before Completion is instructions for the agent only.

Does Verification Before Completion 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 Verification Before Completion 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 Verification Before Completion use?

Verification Before Completion 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 Verification Before Completion use?

About 2.1k tokens (SKILL.md is roughly 8.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Verification Before Completion?

Skills that share tags, products or a category with Verification Before Completion: Show Me Your Work Decision Log (cursor/plugins, 10k stars), Scope Creep Guard (lennney/stop-that-shit, 2.5k stars), Verification Before Completion (farm-fe/farm, 5.6k stars) and PUA High-Agency Governance (tanweai/pua, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Verification Before Completion?

GanyuanRan (a GitHub user) maintains it in GanyuanRan/Aegis, which has 1,330 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 9, 2026.

Source: GanyuanRan/Aegis on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.