- name
SKILL.md
El archivo de la skill permanece en el repositorio del publicador.
Pega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add omagents/omagents --skill ast-grep -a cursor -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add omagents/omagents --skill ast-grep -a claude-code -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add omagents/omagents --skill ast-grep -a codex -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add omagents/omagents --skill ast-grep -a grok -yEnvía el mensaje copiado en un chat de Grok Bot. El Bot obtiene este SKILL.md de GitHub y lo añade a las skills que comparten todos tus Bots.
Install this skill: https://github.com/omagents/omagents/tree/HEAD/packages/core/skills/ast-grepDel publicador
Pattern-aware code search using the ast-grep (sg) binary. Matches code by its syntactic structure, not just text.
Check if ast-grep is installed:
sg --version 2>/dev/null || npx ast-grep --version 2>/dev/null
If not installed, fall back to grep with careful regex patterns.
# Find all console.log calls
sg -p 'console.log($$$)' --lang javascript
# Find all function definitions with a specific name pattern
sg -p 'def $NAME($$$):' --lang python
# Find all if statements with a single return
sg -p 'if ($COND) { return $VAL }' --lang typescript
# Preview first (ALWAYS dry-run before applying)
sg -p 'console.log($$$)' -r 'logger.info($$$)' --lang javascript
# Apply (only after verifying preview)
sg -p 'console.log($$$)' -r 'logger.info($$$)' --lang javascript --update-all
# Check if pattern is valid before searching
sg -p 'pattern' --lang python --json=compact 2>&1 | head -5
Examples:
# Python: find all decorators
@$DECORATOR
def $FUNC($$$):
$$$
# TypeScript: find all arrow functions assigned to const
const $NAME = ($$$) => $BODY
# Rust: find all match arms with panic
$PAT => panic!($$$)
ast-grep auto-detects language from file extension. Override with --lang:
sg -p 'pattern' --lang python
sg -p 'pattern' --lang typescript
sg -p 'pattern' --lang rust
sg -p 'pattern' --lang go
Supported: python, javascript, typescript, rust, go, java, c, cpp, csharp, ruby, php, swift, kotlin, scala, html, css, json, yaml, and more.
For project-wide refactoring, use the loop engine to process files one by one:
# Phase 1: Find all matching files
sg -p 'console.log($$$)' --lang javascript --json=compact | jq '.[].path' | sort -u
# Phase 2: Build task queue
loop_engine.py init ast-grep-refactor '[
{"file": "src/index.js", "description": "Replace console.log with logger.info"},
{"file": "src/utils.js", "description": "Replace console.log with logger.info"}
]'
# Phase 3: Loop - for each file:
# 1. Get next task: loop_engine.py next ast-grep-refactor
# 2. Preview: sg -p 'console.log($$$)' -r 'logger.info($$$)' --lang javascript <file>
# 3. Apply: sg -p 'console.log($$$)' -r 'logger.info($$$)' --lang javascript --update-all <file>
# 4. Verify: run tests/linter
# 5. Complete: loop_engine.py complete ast-grep-refactor <id> "Replaced 3 calls"
If ast-grep is not installed, use grep with careful patterns:
# Instead of sg -p 'console.log($$$)' --lang javascript
grep -rn "console\.log(" --include="*.js" --include="*.ts"
# Instead of sg -p 'def $NAME($$$):' --lang python
grep -rn "def .*(" --include="*.py"
Note: grep matches text, not structure. It will match in strings, comments, and produce false positives.
AST-aware code search and rewrite across 25+ languages using the ast-grep (sg) CLI. Trigger when the agent needs structural code matching, pattern-based search, or pattern-based rewriting. Falls back
---name: ast-grepdescription: AST-aware code search and rewrite across 25+ languages using the ast-grep (sg) CLI. Trigger when the agent…---# packages/core/skills/ast-grep/SKILL.mdResumen general
AST-aware code search and rewrite across 25+ languages using the ast-grep (sg) CLI. Trigger when the agent needs structural code matching, pattern-based search, or pattern-based rewriting. Falls back to grep if ast-grep is not installed.
Preguntas frecuentes
Descarga packages/core/skills/ast-grep/SKILL.md desde el publicador, o copia la ruta y abre el repositorio. PlugMCP lista la skill y no aloja el archivo.
El publicador lo mantiene en https://github.com/omagents/omagents.
Claude, Cursor, Codex y Grok Build pueden leer un SKILL.md que añadas desde el repositorio del publicador. Grok Bot lo instala cuando envías en un chat el enlace a la carpeta de la skill en GitHub.