How do I find the correct 'kind' name for a code element?

You can use the included debug-query command to inspect the Concrete Syntax Tree (CST) of a code snippet, which reveals the exact names used by the parser for different code nodes.

What is 'stopBy: end' in the rules?

It is a critical parameter for relational rules that ensures ast-grep continues searching through the entire code subtree rather than stopping at the first node it encounters.

Can I test rules before running them on my whole project?

Yes, the skill provides a workflow for testing rules against small code snippets using inline CLI commands or temporary rule files to ensure accuracy before scanning the entire codebase.

What makes ast-grep different from regular grep?

Unlike traditional grep which uses text strings, ast-grep understands the code's structure (AST), allowing it to find patterns like 'functions missing try-catch' regardless of formatting or whitespace.

Which programming languages are supported?

This skill supports a wide range of popular languages including JavaScript, TypeScript, Python, Java, Go, Rust, and C++, leveraging the broad language support of the underlying ast-grep tool.

ast-grep Code Search

Name: ast-grep Code Search
Author: zach-source

byzach-source

0•

開発者ツール

Performs high-precision structural code searches and analysis using Abstract Syntax Tree patterns to identify complex programming constructs.

The ast-grep Code Search skill enables Claude to move beyond simple string-based text searches by utilizing Abstract Syntax Tree (AST) matching to identify specific code structures across various programming languages. This skill is essential for complex refactoring, identifying architectural patterns, and enforcing coding standards by allowing users to define precise rules for finding nested logic, specific function signatures, or missing error handling blocks within large codebases. It provides a structured workflow for drafting, testing, and executing rules that understand the syntax and hierarchy of your code rather than just its literal text.

主な機能

01Structural pattern matching using Abstract Syntax Trees (AST)

02Inline and YAML-based rule creation for complex structural queries

03Support for relational rules like 'inside', 'has', 'precedes', and 'follows'

04AST debugging and inspection to visualize code parsing structures

05Multi-language support for precise code analysis across diverse stacks

060 GitHub stars

ユースケース

01Locating all async functions that lack proper try-catch error handling blocks

02Refactoring deprecated function signatures across a large, multi-file codebase

03Identifying specific API method calls nested within particular class structures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zach-source/claude-plugins ast-grep

For use in Claude.ai and ChatGPT

Download Skill