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.
The SKILL.md body is an exemplary lean instruction file: concrete copy-paste commands, explicit constraints and fallback behavior, tight rules with tradeoffs, and a single well-placed reference file for examples. The only notable gap is the absence of an explicit verify-after-set checkpoint in the main workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout: rules are one line each ("Diagnose before explaining.", "Don't check every turn. Costs a tool call."), commands live in compact tables, and the closing "Tomorrow? Memory. This turn only? My." is maximal signal per token. Nothing explains concepts Claude already knows, matching 'lean and efficient; every token earns its place'. | 5 / 5 |
Actionability | Concrete copy-paste-ready commands with real keys and values are given, e.g. `my(action="check", key="context_window_tokens")`, `my(action="set", key="model_preset", value="<preset-name>")`, and `my(action="set", key="max_iterations", value=80)`, covering the common check/set cases. Validated ranges ("max_iterations (1–100)") and the fallback "If tools.my.allow_set is false, check only" add the missing-detail-free specificity of a 5. | 5 / 5 |
Workflow Clarity | The 'How to use' sequence (identify situation → call my tool → warn user before impactful sets → read examples for detail) is clear and includes a pre-set warning checkpoint plus failure-mode handling (rejected direct model writes, allow_set false), matching 'clear sequence with most checkpoints present'. It is not a 5 because there is no explicit post-set verification step (e.g. re-check the key or confirm the preset took effect) in the body. | 4 / 5 |
Progressive Disclosure | The ~70-line body is well-sectioned (When to check, When to set, Anti-patterns, Constraints, Related tools) and pushes detailed examples to a single, clearly signaled, one-level-deep reference: "For detailed examples, read [references/examples.md](references/examples.md)" — the file exists in the bundle with no further nesting. This matches 'clear overview with well-signaled one-level-deep references'. | 5 / 5 |
Total | 19 / 20 Passed |