agentleFS
mblaubergmblauberg/provenant/skills/evaluate/SKILL.md

evaluate

Skill1 starsChanged 4 days agoMITView on GitHub

Use for repeatable evaluation of agents, prompts, rankings or other judgement-bearing systems. Not for deterministic tests or ordinary source review; use test-design or code-review.

25 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use outreach, apply and 7 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.
  • QuixiAISkill

    outreach

    Decide whether a message is worth someone's attention, then reach the user through the outbox, or people on a connected chat channel, on their behalf or your own initiative

    Also in 4 projects that use this

  • proficientlyjobsSkill

    apply

    Fill out a job application on Greenhouse, Lever, or Workday

    Also in 5 projects that use this

  • n24q02mSkill

    compare

    Structured comparison of 2+ alternatives with consistent criteria and decision matrix

    Also in 3 projects that use this

  • dazuckSkill

    interview

    Interview me about a plan to flesh out requirements before implementation. Asks non-obvious questions one at a time until all ambiguities are resolved.

    Also in 3 projects that use this

  • Google CloudSkill

    triage

    Gather context on a change or bug and plan the implementation.

    Also in 4 projects that use this

  • BlockSkill

    plan

    Draft a TDD, PRD, or lightweight plan in the conversation without committing it.

    Also in 3 projects that use this

The file

Files
SKILL.md

Evaluate

Choose an execution oracle first, such as hidden tests or type checks. Use a model grader only for criteria that execution cannot establish; blind it to the treatment and retain criterion evidence and disagreements.

Freeze the decision, task set and split digests, provenance, acceptance criteria, comparator arms, paired seeds and repetitions before observing results. Keep search, acceptance and held-out splits separate. For skills, compare the candidate, no-skill baseline and previous version. Record actual model, harness, effort, cost and failures for each arm.

Use the project's frozen protocols in docs/evals/ where applicable. provenant bench mine prepares benchmark tasks, provenant bench verify checks a frozen task, and provenant bench run runs a split. Consult the bench runbook for inputs and leakage controls. Retain the frozen protocol, task data, attempts and result rows, including errors, omissions and retries. Report raw numerators and denominators, failure clusters and uncertainty; another agent must be able to recompute the result from those artefacts.

Compare against thresholds set in the frozen protocol, not an invented universal margin. Telemetry experiment comparisons are advisory. A result describes its tested distribution, not general safety or delivery acceptance. For stochastic searches report the best found within the sampled envelope, not impossibility. Route defects to implement and unsettled requirements to scope; use deliver for the outcome report.

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.