CtrlK
BlogDocsLog inGet started
Tessl Logo

structural-search

Search code by AST structure using ast-grep. Find semantic patterns like function calls, imports, class definitions instead of text patterns. Triggers on: find all calls to X, search for pattern, refactor usages, find where function is used, structural search, ast-grep, sg.

96

4.00x
Quality

96%

Does it follow best practices?

Impact

96%

4.00x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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

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 a strong skill description that clearly communicates what the skill does (AST-based code search for semantic patterns), when to use it (with explicit trigger phrases), and how it differs from alternatives (structural vs text patterns). The 'Triggers on:' section provides excellent natural language keywords that users would actually say. It uses proper third-person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: search by AST structure, find semantic patterns like function calls, imports, class definitions, and contrasts with text patterns. This gives a clear picture of specific capabilities.

3 / 3

Completeness

Clearly answers both what ('Search code by AST structure... Find semantic patterns like function calls, imports, class definitions') and when ('Triggers on: find all calls to X, search for pattern, refactor usages...'). The 'Triggers on:' clause serves as an explicit 'Use when' equivalent.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms: 'find all calls to X', 'search for pattern', 'refactor usages', 'find where function is used', 'structural search', 'ast-grep', 'sg'. These are phrases users would naturally say.

3 / 3

Distinctiveness Conflict Risk

Clearly distinguished from generic code search or text-based grep by specifying AST/structural search, naming the specific tool (ast-grep/sg), and contrasting with text patterns. Unlikely to conflict with regular search or grep skills.

3 / 3

Total

12

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
NeverSight/skills_feed
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.