Content
93%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 overview skill: token-efficient, fully executable examples, a router table that implements progressive disclosure one level deep, and a validation gate for the de-identification workflow. The only gap is that error-recovery feedback for failed leakage gates is delegated to a companion skill rather than sketched inline, which keeps workflow_clarity at 4.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout: a 14-row handoff table instead of prose, three compact code blocks with inline comments (e.g. "# registry key, HF id, or local path"), and terse rule bullets ("Do not add cloud calls to PHI workflows"). It assumes Claude's competence — no concept is explained that Claude already knows — so it sits on the 5-anchor rather than the 4-anchor ("minor instances of over-explanation"), as even the extras paragraph adds new information beyond the pip block. | 5 / 5 |
Actionability | All guidance is copy-paste ready: exact pip extras ("pip install \"openmed[hf]\""), three fully-parameterized Python calls (openmed.analyze_text, openmed.deidentify, openmed.extract_pii with model_name, output_format, method, policy), CLI equivalents ("openmed analyze --text … --format json"), and runtime discovery calls. These cover the common cases; not a 4 because no key execution detail is missing. | 5 / 5 |
Workflow Clarity | The "typical pipeline" section lays out a clear five-stage sequence (ingest → de-identify → extract → ground → assemble FHIR → evaluate) and a validation gate is explicitly present ("De-identification is verified, not assumed. Gate on leakage with openmed.eval, not on F1 alone"), so the destructive-operation cap does not apply. Not a 5: the error-recovery feedback loop (what to do when leakage is detected) is deferred to the companion skill rather than stated inline, matching the 4-anchor ("most checkpoints present; minor validation gaps") rather than the 5-anchor ("feedback loops for error recovery"). | 4 / 5 |
Progressive Disclosure | This is a router skill executed exactly as the 5-anchor describes: a concise overview whose bulk is a well-signaled, one-level-deep handoff table ("## When to use this skill" → per-task skill/API pairs) with no content inlined that belongs in a deeper file. No bundle files exist to verify (references/, scripts/, assets/ are absent), but structure alone — table-driven navigation, short themed sections — places it clearly above the 4-anchor ("minor organization gaps"). | 5 / 5 |
Total | 19 / 20 Passed |