agentleFS
epicsagasepicsagas/epic-harness/skills/verify/SKILL.md

verify

Skill20 starsChanged 2 months agoApache-2.0View on GitHub

Pre-merge verification gate. Build, test, and lint must all pass before marking done or shipping.

188 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use instinct-export, instinct-import and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • TheKREATORSSkill

    instinct-export

    Export instincts from project/global scope to a file

    Also in 3 projects that use this

  • TheKREATORSSkill

    instinct-import

    Import instincts from file or URL into project/global scope

    Also in 3 projects that use this

  • AviadPSkill

    risk-assess

    Assess the risk and blast radius of a proposed code change before implementing it. Evaluates CI impact, framework-wide vs localized scope, rollback path, and identifies blindspots. Use when user says "what's the risk", "is this safe", "assess the impact", "risk assess", "blast radius", or before applying framework-wide or CI-affecting changes. Do NOT use for code quality review (use code-quality) or plan validation (use design-validator).

    Also in 3 projects that use this

  • diego-tobalinaSkill

    build-fix

    Fix build and compilation errors systematically. Run when build fails.

    Also in 6 projects that use this

  • ArvorCoSkill

    specify

    Create feature specification from natural language description. Use when starting a new feature or creating a spec. Triggers on: create spec, specify feature, new feature spec.

    Also in 10 projects that use this

  • Jurel89Skill

    ai-slop-cleaner

    Clean AI-generated code slop with a regression-safe, deletion-first workflow and optional reviewer-only mode

    Also in 4 projects that use this

  • +1 more from TheKREATORS

The file

We split this skill into the rules it gives an agent

8 rules. 0 are common, 5 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 167 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE.

    line 11
  2. Very specific:

    Before a /go subagent reports "done"

    line 14
  3. Very specific:

    Before /ship creates a PR

    line 15
  4. Distinctive:

    Before telling the user "it's ready"

    line 16
  5. Distinctive:

    After any significant code change

    line 17
  6. Distinctive:

    Must exit 0. If it fails, fix before proceeding.

    line 26
  7. Very specific:

    Must exit 0. If tests fail, invoke debug skill.

    line 33
  8. Distinctive:

    Before reporting "ready", show ALL of these:

    line 65

“Common” is measured: kept by at least 6 in 10 of the 167 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Verify — Pre-Completion Check

Iron Law

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE. "I tested it" without output is an unverified claim.

When to Trigger

  • Before a /go subagent reports "done"
  • Before /ship creates a PR
  • Before telling the user "it's ready"
  • After any significant code change

Process

1. Build

# Detect and run the project's build command
npm run build  # or: go build ./... | cargo build | make

Must exit 0. If it fails, fix before proceeding.

2. Test

# Run the project's test suite
npm test  # or: go test ./... | pytest | cargo test

Must exit 0. If tests fail, invoke debug skill.

3. Lint

# Run linter if configured
npm run lint  # or: golangci-lint run | ruff check | cargo clippy

Warnings are OK. Errors must be fixed.

4. Type Check (if applicable)

npx tsc --noEmit  # TypeScript
mypy .            # Python

5. Final Sanity

  • No console.log / print debug statements left
  • No TODO or FIXME introduced without explanation
  • No hardcoded test values or credentials
  • All new files are tracked by git

Anti-Rationalization

ExcuseRebuttalWhat to do instead
"Tests pass locally"Did you actually run them? Trust the output, not your memory.Run npm test right now. Show the output.
"I only changed one file"One file can break the entire build. Imports propagate.Full build + test. Every time. No exceptions.
"Lint warnings aren't errors"Warnings become errors. Fix them before they multiply.Zero warnings policy. Fix now or suppress with justification.
"CI will catch it"CI feedback is 5-10 min delayed. Catch it locally in seconds.Run verify locally before pushing. CI is the safety net, not the test.

Evidence Required

Before reporting "ready", show ALL of these:

  • Build output: exit code 0 (show the command + result)
  • Test output: all passing (show summary line)
  • Lint output: zero errors (show summary or "clean")
  • Type check output: no errors (show tsc --noEmit or equivalent)
  • Final sanity: no console.log, no unexplained TODO, no hardcoded values

Each check needs actual command output. "I ran it" without output = not verified.

Red Flags

  • Reporting success without showing actual command output
  • Skipping type check "because JavaScript is dynamic"
  • Committing with TODO/FIXME and no explanation

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.