Content
92%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 router-style SKILL.md: lean, unambiguous conditional routing to two real, well-scoped, one-level-deep references. The only soft spot is that the body holds no inline command at all, so even the most common action (e.g., a quick typecheck) requires opening a reference first.
Suggestions
Inline one zero-hop quick-start command (e.g., `pnpm typecheck` or `pnpm --filter @composio/core test`) in the body for the most frequent single-check case, keeping the full command matrix in `references/test-commands.md`.
Trim the duplicated CLI Effect v4 routing paragraph in `references/test-commands.md` (lines 40-47), which restates the SKILL.md body's third paragraph nearly verbatim — link to `effect-v4-cli.md` in one sentence instead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~10-line body contains only a purpose statement and two condition-gated reading directives ("Read `references/test-commands.md` before running broad checks or adding new test coverage"); it explains nothing Claude already knows, and every token earns its place. The brief summary of what `effect-v4-cli.md` covers is navigation signaling, not padding, so it does not fall to the level-4 anchor with trimmable over-explanation. | 5 / 5 |
Actionability | The directives are fully concrete and executable — exact file paths with explicit trigger conditions ("before writing or modifying tests under `ts/packages/cli/test/`") — but the body itself contains no commands or code; the copy-paste-ready `pnpm` commands live one hop away in `test-commands.md`. This is mostly-executable guidance with a minor gap rather than the fully self-contained level-5 anchor, and it is clearly above the pseudocode/missing-details level-3 anchor. | 4 / 5 |
Workflow Clarity | This is a simple single-purpose skill (routing verification choices) under 50 lines, and the single action — pick the right verification by conditionally reading the right reference — is unambiguous, with each read tied to a distinct, non-overlapping trigger. No destructive or batch operations are involved, so the validation cap does not apply and the simple-skill exception holds. | 5 / 5 |
Progressive Disclosure | Verified against the actual bundle: both referenced paths (`references/test-commands.md`, `references/effect-v4-cli.md`) exist, are one level deep, clearly signaled, and condition-gated, with the body acting as a clean overview and all detail appropriately split. The same-level cross-link from `test-commands.md` to `effect-v4-cli.md` aids navigation rather than nesting deeper, matching the clear-overview anchor rather than the level-4 anchor with organization gaps. | 5 / 5 |
Total | 19 / 20 Passed |