Docs 1,257 installs

ast-grep Code Search

by ast-grep/agent-skill

Guide for writing ast-grep rules to perform structural code search and analysis. Use when users need to search codebases using Abstract Syntax Tree (AST)…

Skill content

ast-grep Code Search

Overview

This skill helps translate natural language queries into ast-grep rules for structural code search. ast-grep uses Abstract Syntax Tree (AST) patterns to match code based on its structure rather than just text, enabling powerful and precise code search across large codebases.

When to Use This Skill

Use this skill when users:

- Need to search for code patterns using structural matching (e.g., "find all async functions that don't have error handling")

- Want to locate specific language constructs (e.g., "find all function calls with specific parameters")

- Request searches that require understanding code structure rather than just text

- Ask to search for code with particular AST characteristics

- Need to perform complex code queries that traditional text search cannot handle

General Workflow

Follow this process to help users write effective ast-grep rules: