Content
88%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.
A concise, well-structured, highly actionable instruction skill with a clear passive-suggestion workflow and explicit user-response handling. The only real defects are the dangling references to a detector file absent from the bundle and install hints that are named but never supplied.
Suggestions
Remove or inline the reference to 'generators/suggest-detector.mjs' — the file is not part of this bundle, so the mapping list in step 2 should be presented as the authoritative source.
Provide the actual install hints (or at least one example installHint) in the body instead of deferring to the missing detector file, so step 4 is fully executable.
Consider moving the full pattern-to-component mapping into a references/ file if it grows, keeping SKILL.md as a lean overview with a clearly signaled one-level-deep link.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: a dense one-line detector mapping ('email/SMTP → resend; push notifications → expo-push; setInterval/cron → @convex-dev/crons; ...'), terse rules, and one earned example quote. No padding and no explanation of concepts Claude already knows, matching anchor 5 ('every token earns its place'). | 5 / 5 |
Actionability | Guidance is mostly executable for an instruction-only skill: exact pattern-to-component mappings, a concrete command ('run `/add <component>`'), a model citation example, and rules for decline/ignore. The gap versus anchor 5 is that step 4 defers to 'follow the installHint from the detector', whose contents are not provided anywhere in the skill, leaving a missing detail for execution. | 4 / 5 |
Workflow Clarity | The 5-step workflow is clearly sequenced with explicit branch handling for both outcomes ('If the user says yes: run /add...' / 'If the user says no or ignores it: drop it. Do not repeat.') and a strict passive-timing rule (suggest only after the current task). This is a simple single-purpose skill with an unambiguous sequence and no destructive/batch operations, so it meets the simple-skill exception for a 5. | 5 / 5 |
Progressive Disclosure | The ~24-line body is well organized into Workflow and Rules sections, which alone would merit a 5 under the under-50-line simple-skill exception (no external references needed). However, it points to 'generators/suggest-detector.mjs' and its 'installHint' — a file that does not exist in this bundle — a dangling reference that is a minor organization/navigation gap, fitting anchor 4. | 4 / 5 |
Total | 18 / 20 Passed |