What makes structural search better than standard regex?

Structural search understands the code's syntax (AST), allowing it to ignore comments and formatting while accurately matching logical structures that regex often misses or incorrectly identifies.

How do I match any single node in a pattern?

You can use the $_ wildcard to match any single node, or $$$ to match zero or more nodes in a code structure.

Which programming languages are supported?

It supports a wide range of popular languages including JavaScript, TypeScript, Python, Go, Rust, and C++ through the underlying ast-grep engine.

Can this skill automatically modify my code?

Yes, it can perform semantic rewrites using the rewrite flag, allowing you to safely transform code patterns across your entire project based on structural rules.

Do I need to install external dependencies?

Yes, this skill requires the ast-grep (sg) CLI tool to be installed on your machine via Homebrew, Cargo, or npm to function.

Structural Code Search

Name: Structural Code Search
Author: 0xDarkMatter

by0xDarkMatter

•

Developer Tools

Performs semantic, AST-aware code searches and refactoring to find complex patterns that traditional text-based regex cannot accurately identify.

This skill integrates the power of ast-grep into Claude's environment, enabling high-precision code analysis and transformation based on Abstract Syntax Tree (AST) structures. By understanding the underlying syntax of the code rather than just treating it as text, this tool allows users to find specific function calls, React hooks, imports, and logic patterns across multiple languages including JavaScript, Python, and Go. It is particularly valuable for performing large-scale refactoring, auditing codebases for security anti-patterns, and navigating complex repositories where simple grep would return too many false positives.

Key Features

01Structural code rewriting and automated refactoring capabilities

02Pattern matching with named identifiers ($NAME) and wildcards ($$$)

034 GitHub stars

04Multi-language support for JS, TS, Python, Go, Rust, and more

05AST-aware semantic searching using ast-grep (sg) integration

06Built-in templates for detecting security risks and code smells

Use Cases

01Performing safe, large-scale refactors like changing function signatures or variable declarations

02Locating all instances of specific React hooks or API patterns across a large codebase

03Scanning repositories for security vulnerabilities like XSS vectors or insecure eval() calls

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add 0xdarkmatter/claude-mods structural-search

For use in Claude.ai and ChatGPT

Download Skill