Search, outline, and rewrite code by syntax tree using ast-grep rules.
npx skills add https://github.com/bsamiee/Rasm --skill use-ast-grep-bsamiee
Please help me install this Agent Skill. Skill: use-ast-grep Source: https://github.com/bsamiee/Rasm/tree/main/.claude/skills/use-ast-grep Command: npx skills add https://github.com/bsamiee/Rasm --skill use-ast-grep-bsamiee
ast-grep outline and custom extractors to map declarations and members to source ranges in files too long to read whole. - Use Case: You need to find every hand-written counterpart of a library function across a monorepo and rewrite each call site. Write an ast-grep rule with a fix template, prove it on every sibling form, and apply it with ast-grep scan -U. ## Quick Start Ask the agent to list the declarations in a file or search for a code pattern by syntax tree, for example: outline the functions in src/app.py or find all calls matching a given pattern.High-intent search queries and answers about installing and using this skill.
Write a pattern that is valid code under the language's tree-sitter grammar, using metavariables like $VAR for one node and $$$MULTI for zero-or-more nodes. Run it with ast-grep run -l <lang> -p '<code>' or the find_code MCP tool to get a match list.
Create a YAML rule file with id, language, a rule object combining pattern, kind, and relational keys, plus a fix template that substitutes captured metavariables. Place durable rules under the ruleDirs of sgconfig.yml and apply fixes with ast-grep scan -U.
Use ast-grep when you need structural matching, such as distinguishing declarations from uses or matching a call regardless of argument formatting. Plain text search fits literal strings, but cannot express syntax-tree relations like has, inside, or follows.
Common causes include a rule with no inferable kind set, an anonymous token passed to kind, duplicate keys in one map, or a cyclic dependency through matches. Run with --debug-query=cst to inspect how the pattern parsed and check the load error message.
Yes, customLanguages in sgconfig.yml registers a language with a libraryPath, extensions, and optional outlineRules. languageGlobs can also map file globs to a language ahead of extension detection.
Run ast-grep outline on the file to get each declaration's parsed range, using --match to filter by name and --view expanded for member signatures. Custom extractor rules can be added with --outline-rules for constructs the bundled extractors miss.
ryanthedevDiagnose and configure tree-sitter for AST-powered code extraction.
rodmena-limitedAutomate the feedback loop with LSP diagnostics, AST-grep scanning, and testing.
pohlai88Guides creation of Biome lint rules and assists with queries, diagnostics, actions, and fixtures.
CNifeSearch and rewrite code by matching AST structure across 25 languages.