Content
70%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A clean, well-structured overview that delegates detail appropriately to a verified reference, with clear invocation modes; its main weaknesses are a conceptual intro paragraph and executable examples living only in the reference.
Suggestions
Trim or remove the opening conceptual paragraph about any propagating to callers — Claude already knows this — and keep only the actionable Quick Reference and mode directives.
Inline one minimal before/after code snippet (e.g. any → unknown with a type guard) in the Fix section so the body is actionable without requiring the reference.
Surface a one-line verification cue in the body (e.g. "confirm with eslint --rule @typescript-eslint/no-explicit-any") rather than leaving all verification steps in the reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean with useful Quick Reference bullets and terse mode directives, but the opening paragraph explains why any is harmful — a concept Claude already knows — so it could be tightened rather than earning full efficiency. | 2 / 3 |
Actionability | Guidance is concrete and specific (enumerates explicit annotations, implicit any, assertions to any, and the unknown/generics/Zod replacements), but the executable code examples are offloaded to the reference and directives like "suggest a safer alternative" are slightly open-ended, keeping it below copy-paste-ready. | 2 / 3 |
Workflow Clarity | As a simple single-purpose skill under 50 lines, the body is clearly organized into unambiguous invocation modes (Check / Fix / Explain / Code Review); the simple-skills exception applies and no destructive/batch feedback-loop cap is relevant. | 3 / 3 |
Progressive Disclosure | The body is a concise overview with a well-signaled one-level-deep pointer ("see references/rule.md") whose target file exists and holds the detailed examples and verification steps, matching the clear-overview-with-one-level-reference anchor. | 3 / 3 |
Total | 10 / 12 Passed |