zz-plugin-eval

Evaluates installed plugins through a five-stage locate, profile, define, judge, and report workflow.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/zhixuan312/zz-stack --skill zz-plugin-eval-zhixuan312
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zz-plugin-eval
Source: https://github.com/zhixuan312/zz-stack/tree/main/catalog/zz/zz-plugin-eval/skills/zz-plugin-eval
Command: npx skills add https://github.com/zhixuan312/zz-stack --skill zz-plugin-eval-zhixuan312

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams shipping AI delivery plugins previously evaluated skills and MCP servers separately, so whole-plugin questions like stage recovery and actual tool use went unmeasured, and opinions about plugin quality were settled by whoever read the artifact last rather than by an agreed ruler. ## Core Features & Use Cases - Five-stage evaluation flow: locate the plugin at a released version, profile trace evidence, define what good means, judge against the approved ruler, and report findings. - Gated scoring: nothing is scored before a person approves rulers.md, and nothing closes before a person reads findings.md; scoring runs through a pinned model via round_judge, never the orchestrating agent. - Honest insufficiency handling: thin trace history yields an explicit not measured rather than a fabricated score, with document- and initiative-scoped rulers as fallbacks. - Use case: A team lead asks whether a plugin's flow is going in circles. Instead of agreeing from a personal read, the flow profiles five usable runs, applies the pre-agreed ruler, and produces a gated findings document. ## Quick Start Invoke the /zz-plugin-eval:eval command to start a gated evaluation of one installed plugin at a released version.

Frequently Asked Questions about zz-plugin-eval

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate whether an installed plugin is any good?▼

Invoke the plugin evaluation entry command, which runs five stages: locate the plugin at a released version, profile its trace evidence, define a ruler, judge against it, and report findings. Scoring only happens after a person approves the ruler.

How does plugin scoring work without the agent judging artifacts itself?▼

Scoring is delegated to a round_judge tool that takes a plugin, version, and ruler id and runs a model pinned by the deployment. The orchestrating agent writes observations into findings.md but never enters scores, keeping every number comparable.

What happens when a plugin has too few runs to evaluate?▼

A thin trace block is reported as an honest not measured rather than routed around. Rulers scoped to documents or initiatives read artifacts instead of runs, so evaluation may still proceed when trace history is insufficient.

Can I compare two plugins using their evaluation scores?▼

No. Every ruler is specific to its own plugin, so two scores are measured with two different rulers and are not comparable. The flow deliberately provides no leaderboard.

When should the case suite be run during plugin profiling?▼

Only when somebody deliberately asks for it. Each case costs real money on the caller's own credential, roughly $0.40 per case, so a stale-looking profile alone is not a reason to run it.