Content
76%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 lean, highly actionable detection guide with concrete anti-patterns, per-pattern fixes, and a correct-use code example that prevents false positives. The main gap is the workflow: fixes are applied by default with no post-fix validation step, which matters when the scope is an entire codebase.
Suggestions
Add a verification step after applying fixes, e.g. "After fixes, run the project's typecheck or tests to confirm behavior is unchanged".
Merge pattern 3 into pattern 1 — both cover handlers passed only to native elements — to remove the redundancy.
Qualify the ".claude/rules/sim-hooks.md" reference so it is only applied when that rules file exists in the target repo.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean throughout — assumes React competence and explains only the observer rule, which is the crux, not common knowledge. Minor redundancy: pattern 1's "used as a native element handler (`<button onClick={fn}>`)" duplicates pattern 3, and "the reference is unobserved and `useCallback` adds overhead with zero benefit" restates pattern 1's ground. | 4 / 5 |
Actionability | Fully concrete guidance: seven named anti-patterns with inline triggers, a do-not-flag code example for the codebase's ref pattern, and explicit fixes per pattern ("Remove `useCallback`", "Use `useMemo` on the return value instead"). Covers the common cases for an instruction-only skill. | 5 / 5 |
Workflow Clarity | The three-step sequence is clear ("1. Read the reference above / 2. Analyze the specified scope / 3. If fix=true, apply the fixes"), but there is no validation or verification step after applying fixes. With fix defaulting to true and scope reaching "whole codebase", this is batch code modification without a checkpoint, which caps workflow clarity at 3. | 3 / 5 |
Progressive Disclosure | A single well-sectioned file with one clearly signaled one-level reference ("Read before analyzing: 1. https://react.dev/reference/react/useCallback"); nothing is inlined that belongs in a separate file. Minor gap: pattern 7 cites ".claude/rules/sim-hooks.md", a project rules file that may not exist in the target repo. | 4 / 5 |
Total | 16 / 20 Passed |