Skip to content

docs(skills): add the four-stage model evaluation loop - #1032

Closed
jswir wants to merge 2 commits into
mainfrom
skills/eval-loop
Closed

docs(skills): add the four-stage model evaluation loop#1032
jswir wants to merge 2 commits into
mainfrom
skills/eval-loop

Conversation

@jswir

@jswir jswir commented Aug 17, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • mirror the four shared evaluation skills from ms2data/agent-skills#81: deterministic answer scoring, failure diagnosis, evidence-backed model improvement, and the gated evaluation loop
  • expose the skills through Claude discovery, the Publisher skill index, the npm skills package, and the generated MCP prompt bundle
  • keep the shared files byte-identical with upstream; upstream Update publisher run instructions #81 was normalized to Publisher's punctuation policy in ms2data/agent-skills@4941858

Test plan

  • bun run test:skills
  • cd packages/server && bun test src/mcp/skills
  • verify all six shared files match the upstream PR head byte-for-byte
  • exercise the loop end-to-end against a local Publisher package (follow-up validation in progress)

Made with Cursor

jswir and others added 2 commits August 16, 2026 19:42
Mirror the shared evaluation suite so Publisher agents can measure, diagnose, and improve semantic models with deterministic scoring and gated edits.

Co-authored-by: Cursor <cursoragent@cursor.com>
Bump the skills package so the new evaluation workflow is published instead of being skipped as unchanged.

Co-authored-by: Cursor <cursoragent@cursor.com>
@jswir

jswir commented Sep 2, 2026

Copy link
Copy Markdown
Collaborator Author

Superseded by #1101, which ports the loop as it stands today (with the scripts, the ledger contract, the golden verifier and the run viewer) on top of the manifest in #1088. This branch was a five-week-old snapshot without the scripts; rebasing it would have meant porting things that had since moved. Closing rather than rebasing.

@jswir jswir closed this Sep 2, 2026
jswir added a commit that referenced this pull request Sep 2, 2026
…al-diagnose, eval-improve

The four skills that evaluate a semantic model: a set of questions whose
goldens are computed from raw tables in a truth package the answerer cannot
reach, a blind answerer over the model holding only the analysis skills, a
judge that sees the golden and the re-executed rows and may doubt the golden,
a diagnosis of each failure that says which artifact owns it, and one smallest
model edit gated by a re-run. With the scripts that make it a loop: a runner
that refuses to start on drifted goldens or a dead server, a golden verifier,
a truth-package scaffold, a server spawner, a browsable run package, and a
shared ledger that every stage writes through.

Shared skills, identical to upstream (ms2data/agent-skills#81) and registered
in publisher-local.json under the new eval group. The manifest's analysis and
modeling groups are what the loop installs for the agents it measures, so
the same scripts run from this checkout unchanged. The engine-side evaluation
of get_context itself is deliberately not here: it is Credible's question
about its hosted engine and stays in an unlisted skill upstream.

Supersedes #1032, a port of a five-week-old snapshot that predates the
scripts. Bundle regenerated; 18 bundle, 169 manifest tests and check-pack
pass. credibledata/malloy-samples#23 is a set anyone can run this on.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant