This is an excellent skill file that efficiently teaches ast-grep usage. It nails the balance between providing enough actionable detail (constraints, workflow, examples) while deferring comprehensive reference material to clearly-signaled supporting files. The constraints section is particularly strong, identifying the most common failure modes with specific solutions rather than generic advice.

Dimension	Reasoning	Score
Conciseness	The content is lean and efficient. Every constraint and workflow step teaches something specific to ast-grep that Claude wouldn't already know. The introductory paragraph is brief and establishes the mental model (patterns vs YAML rules, ~60/40 split) without over-explaining ASTs or tree-sitter.	3 / 3
Actionability	Provides fully executable CLI commands and complete YAML rule examples that are copy-paste ready. Examples cover the key use cases (search, rewrite, relational rules, context/selector) with concrete syntax, and constraints specify exact pitfalls with specific solutions.	3 / 3
Workflow Clarity	The 7-step workflow is clearly sequenced with explicit validation checkpoints (steps 5 and 6), a feedback loop ('when a rule doesn't work, go back to step 3'), and a final verification step. The emphasis on testing after each incremental addition and verifying against positive/negative cases is excellent for this error-prone domain.	3 / 3
Progressive Disclosure	The main content provides a concise overview with constraints, workflow, and examples, then cleanly references five well-organized one-level-deep reference files (pattern-syntax, rule-reference, yaml-config, cli, recipes) with clear descriptions of what each contains.	3 / 3
	Total	12 / 12 Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that clearly defines what ast-grep does (AST-based code search, lint, rewrite), when to use it (structural pattern matching, codemods, API migration), and when to prefer it over alternatives (regex grep for syntactic constructs). It uses third person voice, includes rich trigger terms, and provides concrete examples of match targets.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: 'code search', 'lint', 'rewrite', 'finding code patterns structurally', 'writing lint rules', 'building codemods', 'migrating API usage'. These are all concrete, well-defined actions.	3 / 3
Completeness	Clearly answers both what ('AST-based code search, lint, and rewrite using ast-grep') and when ('Use when finding code patterns structurally, writing lint rules, building codemods, or migrating API usage'). Also includes a helpful disambiguation clause ('Prefer over regex grep when...').	3 / 3
Trigger Term Quality	Excellent coverage of natural terms: 'ast-grep', 'code patterns', 'lint rules', 'codemods', 'API migration', 'function call', 'import', 'class field', 'assignment', 'syntactic construct'. These are terms users would naturally use when needing this skill, and the contrast with 'regex grep' helps clarify when to prefer it.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive with clear niche: AST-based structural code analysis via ast-grep. The explicit contrast with regex grep and the focus on syntactic constructs makes it very unlikely to conflict with general search or text-based grep skills.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Reviewed

22 days ago

Table of Contents

Discovery Implementation Validation