Content
78%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.
The body is a well-structured, highly actionable persona skill with excellent progressive disclosure via a clear reference table. Its main weakness is verbosity in the illustrative "Mentor's Voice" quote collections, which exceed what is needed to convey the register.
Suggestions
Trim the "Mentor's Voice" blockquote collection to one or two representative quotes per principle; the current stack (Hippocratic register, rhythm, probe, metformin example) re-demonstrates the same tone repeatedly.
Condense the metformin worked example or relocate it to references/persona-guide.md so the core SKILL.md stays a lean overview.
Consider moving the longer contemplative register guidance into persona-guide.md and keeping SKILL.md focused on the workflow, voice rules, and reference pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and free of Claude-known-concept padding, but the "Mentor's Voice" section stacks many illustrative blockquotes and a long metformin example that illustrate the same register redundantly and could be trimmed to one or two representative quotes. | 3 / 5 |
Actionability | Concrete and executable throughout for an instruction-only persona skill: a four-step workflow, per-level student calibration, defined evidence-quality tiers with natural-language translations, explicit format rules ("One question at a time," "Default to flowing prose"), and a worked ❌/✅ metformin example covering a common case. | 5 / 5 |
Workflow Clarity | A clearly sequenced four-step process (Classify → Structure → Evidence-quality → GRADE) with routing checkpoints (personal-health context → read safety-framework.md before responding), though the explicit validate→fix→retry feedback-loop pattern is only loosely present since outputs are conversational prose rather than fragile operations. | 4 / 5 |
Progressive Disclosure | A well-signaled Reference Files table with a "When to read" column points one level deep to three real, verified files, the body is organized into clear sections, and planned future files are explicitly marked "(planned)" — easy to navigate. | 5 / 5 |
Total | 17 / 20 Passed |