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 deliberately thin, harness-generated proxy that is maximally token-efficient and unambiguous about its single action. Its weakness is that it is a pure redirect: no overview, no fallback if the shared path is missing, and navigation depends entirely on a file outside the skill bundle.
Suggestions
Add a one-line overview of what the shared skill does so the redirect is not entirely blind, e.g. "The shared skill defines the interview loop: one question at a time, pursue weak answers, stop at three 'I don't know's."
Add a brief fallback for when `~/.agents/skills/grill-me/SKILL.md` is absent (e.g. "If the shared skill is missing, run a relentless one-question-at-a-time interview: challenge assumptions, pursue weak answers, stop at three 'I don't know's.").
If the target content is stable, consider mirroring the core interview rules inline so the skill is self-contained and the reference is only needed for optional detail.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two functional lines ("Load and follow the shared skill at `~/.agents/skills/grill-me/SKILL.md`.") plus a generation comment — zero padding and no explanation of anything Claude already knows. This matches anchor 5 ("Lean and efficient; assumes Claude's competence; every token earns its place"). | 5 / 5 |
Actionability | The single directive is fully specified with a concrete path, so it is executable as written; but it delegates all actual guidance to an external file outside the skill bundle and offers no fallback if that file is absent. This fits anchor 4 ("Mostly executable guidance... minor gaps") better than anchor 5, which expects the guidance itself to cover the common cases. | 4 / 5 |
Workflow Clarity | As a single-action skill the instruction ("Load and follow") is unambiguous, matching the simple-skill exception, but there is no checkpoint for the failure mode where the referenced shared skill does not exist. This places it at anchor 4 ("Clear sequence with most checkpoints present; minor validation gaps") rather than 5; no destructive/batch cap applies. | 4 / 5 |
Progressive Disclosure | The reference is clearly signaled and only one level deep, but the body contains no overview of what the target skill covers, and the pointer lives outside the skill bundle (`~/.agents/...`), so navigation cannot be verified from the skill itself. This falls between anchors 3 and 4; the absent overview and unverifiable external target tip it to 3. | 3 / 5 |
Total | 16 / 20 Passed |