Content
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, well-structured skill that provides highly actionable, copy-paste ready ast-grep commands organized into logical sections. The conciseness is excellent—no wasted tokens explaining concepts Claude already knows. The main weakness is that the referenced bundle files (six reference docs and a YAML template) don't exist, making the progressive disclosure promises hollow.
Suggestions
Either provide the referenced bundle files (js-ts-patterns.md, python-patterns.md, etc.) or remove the references to avoid dead links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, using tables and code examples without unnecessary explanation. It doesn't explain what ASTs are or how ast-grep works internally—it jumps straight to actionable patterns and commands. | 3 / 3 |
Actionability | Every pattern is a copy-paste ready command with concrete examples across multiple languages. The quick reference table provides exact flags and syntax for all common operations. | 3 / 3 |
Workflow Clarity | For a search/refactor tool, the workflow is clear: find patterns, preview replacements with `-r`, then apply with `--rewrite`. The separation of preview vs. apply is an implicit but clear validation checkpoint appropriate for this tool's risk level. | 3 / 3 |
Progressive Disclosure | The skill references six files under `./references/` and one asset, which is good structure, but no bundle files are provided so these references are unverifiable dead links. The main content itself is well-organized with clear sections, but the referenced files don't actually exist in the bundle. | 2 / 3 |
Total | 11 / 12 Passed |