agentleFS
ForgeyClapForgeyClap/Forge-Core/.claude/skills/forge-graded-verify/SKILL.md

forge-graded-verify

Skill2 starsChanged 6 days agoMITView on GitHub

Use to grade RAG, research, scraping or prediction answers (beoordeel).

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Bounded single rework loop: if any required criterion scores < the threshold (default 3), emit ONE rework_task_created → rework_assigned to …

    line 18

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

forge-graded-verify — advisory rubric-scored verification (scout #7)

Fills the graded-quality axis Forge deliberately lacks: forge-verify checks structural bookkeeping ("did the agent close its tickets"); forge-evals is intentionally deterministic-binary so it can safely gate git reverts. Neither scores subjective ANSWER QUALITY. This skill adds that — advisory only. Method reimplemented from the DeepVerifier failure-taxonomy pattern (arXiv 2601.15808); no code/dataset from that repo is used.

When to use

High-stakes answer-quality work where "did it pass an assertion" isn't enough: RAG answers, research syntheses, scraped-data summaries, prediction rationales. NOT for code/build gating (that stays with forge-evals + integration-gate). Reserve for genuinely high-stakes tasks — it costs an LLM review pass; don't duplicate ultra-review.

How it works (advisory, bounded, never gates irreversible actions)

  1. Pick the rubric for the domain from .claude/config/rubrics/<domain>.json. Each criterion has: id, descriptor (4-level: 1=poor … 4=excellent, what each level means), and raise (what would move the score up).
  2. Dispatch review-boss as a GRADED verifier (not the binary reviewer): it reads the output + the source/context, and returns per-criterion {id, score 1-4, evidence, feedback} via verification-by-decomposition (judge each criterion separately, cite evidence).
  3. Optional dual review for high-stakes work: for high-stakes answers only (RAG, research, prediction), an optional dual-review pattern with two independent reviewers using the same rubric can provide stronger confidence. A split verdict (reviewers disagree) gets one rework round, never a loop. This doubles review usage, so it is advisory-only, not the default.
  4. Bounded single rework loop: if any required criterion scores < the threshold (default 3), emit ONE rework_task_created → rework_assigned to the owning Boss with the NL feedback, re-grade ONCE, respect the usage-guard. No open-ended loops.
  5. Log advisory only: record the graded result via the existing gate_evaluated / lead_review_completed events (do NOT invent event types). NEVER let a graded score gate an irreversible action (deploy, git revert, send) — deterministic forge-evals / owner approval stay authoritative there.

Honesty

LLM-graded scores are judgment, not ground truth (a judge can mislabel). Frame results as advisory quality signals; cite per-criterion evidence; the reviewer model should differ from the builder model (evaluator independence). Rubrics are owner-editable JSON — start from the shipped ones and ADAPT per project, don't drop-in.

Rubrics

Shipped starters in .claude/config/rubrics/: rag.json (source-grounding, reasoning soundness, coverage, answer-correctness, completeness), payments.json (no-raw-PAN, money-integrity, idempotency, webhook-security, test/live-safety), ecommerce.json (real-catalog, inventory-safety, order-idempotency, flow-integrity, connector-safety), electron.json (renderer-hardening, ipc-safety, csp/secrets, installer-reality, no-mock-data), voice.json (dutch-first-ux, turn-discipline, barge-in/latency, consent/disclosure, action-safety). Add more per-domain rubrics as needed (research, scraping, prediction) with the same shape.

Gate cards vs rubrics

Rubrics here are advisory 1-4 quality scores. The binary per-domain checklist is a separate thing: the quality gate card that Verify Boss requests with node .claude/forge-bin/forge-quality.cjs gate --domain <domain> and marks PASS / FAIL / NOT_RUN with evidence (cards live in .claude/config/quality/cards/, see forge-quality). A rubric score never replaces a gate-card check.

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.