Claude Skill

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.

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download 0xdarkmatter-claude-mods-skills_structural-search-3dfaf0b.zip · 8 KB

Install

skills CLI npx skills add https://github.com/0xDarkMatter/claude-mods/tree/main/skills/structural-search
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install 0xdarkmatter-claude-mods@llmmart
Git git clone https://github.com/0xDarkMatter/claude-mods.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole 0xdarkmatter/claude-mods collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Structural Search

Search code by its abstract syntax tree (AST) structure. Finds semantic patterns that regex cannot match reliably.

Tools

Tool Command Use For
ast-grep sg -p 'pattern' AST-aware code search

Pattern Syntax

Pattern Matches Example
$NAME Named identifier function $NAME() {}
$_ Any single node console.log($_)
$$$ Zero or more nodes function $_($$$) {}

Top 10 Essential Patterns

# 1. Find console.log calls
sg -p 'console.log($_)'

# 2. Find React hooks
sg -p 'const [$_, $_] = useState($_)'
sg -p 'useEffect($_, [$$$])'

# 3. Find function definitions
sg -p 'function $NAME($$$) { $$$ }'
sg -p 'def $NAME($$$): $$$' --lang python

# 4. Find imports
sg -p 'import $_ from "$_"'
sg -p 'from $_ import $_' --lang python

# 5. Find async patterns
sg -p 'await $_'
sg -p 'async function $NAME($$$) { $$$ }'

# 6. Find error handling
sg -p 'try { $$$ } catch ($_) { $$$ }'
sg -p 'if err != nil { $$$ }' --lang go

# 7. Find potential issues
sg -p '$_ == $_'           # == instead of ===
sg -p 'eval($_)'           # Security risk
sg -p '$_.innerHTML = $_'  # XSS vector

# 8. Preview refactoring
sg -p 'console.log($_)' -r 'logger.info($_)'

# 9. Apply refactoring
sg -p 'var $NAME = $_' -r 'const $NAME = $_' --rewrite

# 10. Search specific language
sg -p 'pattern' --lang typescript

Quick Reference

Task Command
Find pattern sg -p 'pattern'
Specific language sg -p 'pattern' --lang python
Replace (preview) sg -p 'old' -r 'new'
Replace (apply) sg -p 'old' -r 'new' --rewrite
Show context sg -p 'pattern' -A 3
JSON output sg -p 'pattern' --json
File list only sg -p 'pattern' -l
Count matches sg -p 'pattern' --count
Run YAML rules sg scan

When to Use

  • Finding all usages of a function/method
  • Locating specific code patterns (hooks, API calls)
  • Preparing for large-scale refactoring
  • When regex would match false positives
  • Detecting anti-patterns and security issues
  • Creating custom linting rules

Additional Resources

For complete patterns, load:

  • ./references/js-ts-patterns.md - JavaScript/TypeScript patterns
  • ./references/python-patterns.md - Python patterns
  • ./references/go-rust-patterns.md - Go and Rust patterns
  • ./references/security-patterns.md - Security vulnerability detection
  • ./references/advanced-usage.md - YAML rules and tool integration
  • ./assets/rule-template.yaml - Starter template for custom rules
Files (claude-mods)
  • assets
    • rule-template.yaml 736 B
      Loading…
  • references
    • advanced-usage.md 4.3 KB
      Loading…
    • go-rust-patterns.md 3.2 KB
      Loading…
    • js-ts-patterns.md 2.4 KB
      Loading…
    • python-patterns.md 2.3 KB
      Loading…
    • security-patterns.md 3.1 KB
      Loading…
  • scripts
    • .gitkeep 0 B · in bundle
  • SKILL.md 3.1 KB
    ---
    name: structural-search
    description: "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."
    license: MIT
    compatibility: "Requires ast-grep (sg) CLI tool. Install: brew install ast-grep (macOS) or cargo install ast-grep (cross-platform)."
    allowed-tools: "Bash"
    metadata:
      author: claude-mods
    ---
    
    # Structural Search
    
    Search code by its abstract syntax tree (AST) structure. Finds semantic patterns that regex cannot match reliably.
    
    ## Tools
    
    | Tool | Command | Use For |
    |------|---------|---------|
    | ast-grep | `sg -p 'pattern'` | AST-aware code search |
    
    ## Pattern Syntax
    
    | Pattern | Matches | Example |
    |---------|---------|---------|
    | `$NAME` | Named identifier | `function $NAME() {}` |
    | `$_` | Any single node | `console.log($_)` |
    | `$$$` | Zero or more nodes | `function $_($$$) {}` |
    
    ## Top 10 Essential Patterns
    
    ```bash
    # 1. Find console.log calls
    sg -p 'console.log($_)'
    
    # 2. Find React hooks
    sg -p 'const [$_, $_] = useState($_)'
    sg -p 'useEffect($_, [$$$])'
    
    # 3. Find function definitions
    sg -p 'function $NAME($$$) { $$$ }'
    sg -p 'def $NAME($$$): $$$' --lang python
    
    # 4. Find imports
    sg -p 'import $_ from "$_"'
    sg -p 'from $_ import $_' --lang python
    
    # 5. Find async patterns
    sg -p 'await $_'
    sg -p 'async function $NAME($$$) { $$$ }'
    
    # 6. Find error handling
    sg -p 'try { $$$ } catch ($_) { $$$ }'
    sg -p 'if err != nil { $$$ }' --lang go
    
    # 7. Find potential issues
    sg -p '$_ == $_'           # == instead of ===
    sg -p 'eval($_)'           # Security risk
    sg -p '$_.innerHTML = $_'  # XSS vector
    
    # 8. Preview refactoring
    sg -p 'console.log($_)' -r 'logger.info($_)'
    
    # 9. Apply refactoring
    sg -p 'var $NAME = $_' -r 'const $NAME = $_' --rewrite
    
    # 10. Search specific language
    sg -p 'pattern' --lang typescript
    ```
    
    ## Quick Reference
    
    | Task | Command |
    |------|---------|
    | Find pattern | `sg -p 'pattern'` |
    | Specific language | `sg -p 'pattern' --lang python` |
    | Replace (preview) | `sg -p 'old' -r 'new'` |
    | Replace (apply) | `sg -p 'old' -r 'new' --rewrite` |
    | Show context | `sg -p 'pattern' -A 3` |
    | JSON output | `sg -p 'pattern' --json` |
    | File list only | `sg -p 'pattern' -l` |
    | Count matches | `sg -p 'pattern' --count` |
    | Run YAML rules | `sg scan` |
    
    ## When to Use
    
    - Finding all usages of a function/method
    - Locating specific code patterns (hooks, API calls)
    - Preparing for large-scale refactoring
    - When regex would match false positives
    - Detecting anti-patterns and security issues
    - Creating custom linting rules
    
    ## Additional Resources
    
    For complete patterns, load:
    - `./references/js-ts-patterns.md` - JavaScript/TypeScript patterns
    - `./references/python-patterns.md` - Python patterns
    - `./references/go-rust-patterns.md` - Go and Rust patterns
    - `./references/security-patterns.md` - Security vulnerability detection
    - `./references/advanced-usage.md` - YAML rules and tool integration
    - `./assets/rule-template.yaml` - Starter template for custom rules
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.