Content
57%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 maximally lean delegation stub: perfectly token-efficient, but it delegates 100% of the skill's substance to an external file that is neither part of the bundle nor present in this environment. As written, the skill provides a pointer without any usable guidance, fallback, or self-contained content.
Suggestions
Inline a minimal core instruction (e.g., a short grilling protocol: interrogate assumptions, demand specifics, expose risks) so the skill remains useful when the shared file cannot be loaded.
Add a fallback step for when `~/.agents/skills/grilling/SKILL.md` is missing, such as proceeding with the inlined minimal protocol instead of failing.
Ship the referenced content inside the skill bundle (e.g., copy the shared SKILL.md into `references/` and link relatively) so the one-level-deep reference actually resolves.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two lines with zero padding: no concept explanations, no repetition — "Load and follow the shared skill at ~/.agents/skills/grilling/SKILL.md" plus a one-line provenance comment. Every token earns its place and it fully assumes Claude's competence, matching the 'lean and efficient' anchor; the single HTML comment is maintenance metadata, not over-explanation. | 5 / 5 |
Actionability | The only guidance is a pointer to a specific path — concrete as a command, but it contains no substantive instruction on how to grill, fitting 'minimal concrete guidance; missing the specific steps to execute'. It is not a 1 because the instruction is executable rather than vague, and not a 3 because the referenced target does not exist in this environment or in the bundle, leaving no usable guidance at all. | 2 / 5 |
Workflow Clarity | The single step (load and follow the external file) is clearly stated, but there is no checkpoint or fallback for the case where `~/.agents/skills/grilling/SKILL.md` is absent — a real gap since the file is indeed missing here — and the actual grilling workflow is entirely undefined in this document. This matches 'steps present but checkpoints missing' rather than the mostly-checkpointed level 4. | 3 / 5 |
Progressive Disclosure | The reference to `~/.agents/skills/grilling/SKILL.md` is one level deep and clearly signaled, but it points outside the skill bundle to a home-directory path that does not resolve in this environment, and the comment's cited `scripts/agent-harnesses.py` is likewise absent from the bundle. Structure exists but the skill's content is not actually shipped or navigable, which falls between the clearly-signaled level 4 and the broken-navigation level 2. | 3 / 5 |
Total | 13 / 20 Passed |