Content
92%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An exemplary operational skill: copy-paste pytest/CLI/CI examples with explicit exit semantics, a validated workflow with fail-closed checkpoints, and a gotchas section that preempts real failure modes (leaked splits, un-required checks, auto-written baselines). The only ding is version-sensitive milestone pins embedded in the primary examples rather than quarantined from the durable guidance.
Suggestions
Move milestone- and version-specific values (v1.6, G1A_V16_RECALL_FLOOR, hipaa_safe_harbor pins) out of the primary code examples into a clearly marked 'current milestone pins' section, or instruct the reader to read the active milestone from openmed.eval.release_gates instead of hardcoding it.
In the pytest example, derive the recall floor from the module (e.g. from openmed.eval.release_gates import G1A_V16_RECALL_FLOOR) rather than re-declaring RECALL_FLOOR = 0.99, so the example cannot drift from the published floors.
Add one line showing how to discover the current milestone/policy pair (e.g. a command or constant listing active profiles) so CI authors pin the right values without guessing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — no concept re-teaching, every section load-bearing — but time-sensitive pins are hardcoded in the main examples ('milestone="v1.6"', 'G1A_V16_RECALL_FLOOR', v1.6 vs v2.0 floors) rather than isolated in a versioned/deprecated section, which can silently age. The 'Pin the model and milestone' gotcha mitigates but does not relocate this, so it fits anchor 4 more than 5. | 4 / 5 |
Actionability | Fully executable throughout: a copy-paste pytest module with file path, fixtures, and assertions; a CLI invocation with flags plus an exit-code table; and a complete GitHub Actions YAML. Covers the common cases (pytest path and CLI path) directly. | 5 / 5 |
Workflow Clarity | The 6-step Workflow is clearly sequenced with explicit checkpoints — assert the two invariants, 'Mark the job a required status check', 'treat it as a failure' on missing report, and the '--issue-on-failure' feedback loop for failure recovery. Not 4 because validation and error-recovery steps are explicit, not implicit. | 5 / 5 |
Progressive Disclosure | No bundle files exist and none are needed at this scope: everything sits at SKILL.md altitude, and detail is properly delegated with well-signaled one-level hand-offs ('For the full gate semantics see evaluating-with-leakage-gates', building-gold-corpus, authoring-model-cards). Sections are cleanly organized for navigation. | 5 / 5 |
Total | 19 / 20 Passed |