ast-grep Structural Search
code-yeongyu/oh-my-openagent
Searches and rewrites code by syntax-tree shape across 25 languages with ast-grep, for codemods, structural queries and YAML lint rules, using a Python wrapper script.
Map file structure, imports, exports, and direct members with ast-grep before reading selected source.
AGPL-3.0Auto-check passed
Install Ast Grep Outline
$ npx skills add nodetool-ai/nodetool --skill ast-grep-outline -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install nodetool-ai/nodetool ast-grep-outline --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/ast-grep-outline .claude/skills/ast-grep-outline && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "ast-grep-outline" agent skill from https://github.com/nodetool-ai/nodetool/tree/main/.agents/skills/ast-grep-outline into .claude/skills/ast-grep-outline/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ast-grep-outline", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/nodetool-ai/nodetool/tree/main/.agents/skills/ast-grep-outlineType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add nodetool-ai/nodetool --skill ast-grep-outline -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install nodetool-ai/nodetool ast-grep-outline --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/ast-grep-outline .agents/skills/ast-grep-outline && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "ast-grep-outline" agent skill from https://github.com/nodetool-ai/nodetool/tree/main/.agents/skills/ast-grep-outline into .agents/skills/ast-grep-outline/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ast-grep-outline", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add nodetool-ai/nodetool --skill ast-grep-outline -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install nodetool-ai/nodetool ast-grep-outline --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/ast-grep-outline .cursor/skills/ast-grep-outline && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "ast-grep-outline" agent skill from https://github.com/nodetool-ai/nodetool/tree/main/.agents/skills/ast-grep-outline into .cursor/skills/ast-grep-outline/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ast-grep-outline", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/nodetool-ai/nodetool.git --path .agents/skills/ast-grep-outline--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add nodetool-ai/nodetool --skill ast-grep-outline -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install nodetool-ai/nodetool ast-grep-outline --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/ast-grep-outline .gemini/skills/ast-grep-outline && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "ast-grep-outline" agent skill from https://github.com/nodetool-ai/nodetool/tree/main/.agents/skills/ast-grep-outline into .gemini/skills/ast-grep-outline/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ast-grep-outline", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install nodetool-ai/nodetool ast-grep-outlineInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add nodetool-ai/nodetool --skill ast-grep-outline -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/ast-grep-outline .github/skills/ast-grep-outline && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "ast-grep-outline" agent skill from https://github.com/nodetool-ai/nodetool/tree/main/.agents/skills/ast-grep-outline into .github/skills/ast-grep-outline/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ast-grep-outline", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add nodetool-ai/nodetool --skill ast-grep-outline -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install nodetool-ai/nodetool ast-grep-outline --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/ast-grep-outline .opencode/skills/ast-grep-outline && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "ast-grep-outline" agent skill from https://github.com/nodetool-ai/nodetool/tree/main/.agents/skills/ast-grep-outline into .opencode/skills/ast-grep-outline/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ast-grep-outline", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
ast-grep-outline- GitHub stars
- 560
- Used in
- 1 other repo
- Token cost
- ~845 tokens
- SKILL.md length
- 393 words
- Files
- 1
- Skills in repo
- 127
- Repo updated
- First seen
- Licence
- AGPL-3.0
At a glance
Map file structure, imports, exports, and direct members with ast-grep before reading selected source.
- SKILL.md covers When To Use It, Argument Guide, Limits and NodeTool notes
- Calls npx and git
What it does
Ast Grep Outline is an agent skill from nodetool-ai/nodetool. Map file structure, imports, exports, and direct members with ast-grep before reading selected source.
Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
The repository describes itself as: Agent-first Creative Workspace. The licence is AGPL-3.0.
Example prompts
- “/ast-grep-outline”
Requirements
- Node.js
What it can do on your machine
Read from SKILL.md and the folder at commit 339f069. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npxgit
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Ast Grep Outline loads about 845 tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 393 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from nodetool-ai/nodetool at commit 339f069, republished under its AGPL-3.0 licence (© nodetool-ai). 393 words, ~845 tokens.
Download SKILL.mdSave it as
.claude/skills/ast-grep-outline/SKILL.md (or your agent's skills folder).- name
- ast-grep-outline
- description
- Map file structure, imports, exports, and direct members with ast-grep before reading selected source.
Use ast-grep outline
ast-grep outline prints a compact structural map of source code with line
numbers: top-level items (imports, functions, classes, structs,
interfaces, modules, enums) and their direct members (fields, methods,
constructors, enum variants). It is a local, syntax-only view — cheap enough
to run before any full file read.
Read code in stages: find candidate files with search or file names, outline them, then open only the source range the outline points to. Defaults adapt to input: a file shows its local structure with member digests; a directory shows only its exported surface as grouped names.
When To Use It
Understand a file before editing. Get a table of contents, dependencies, and public entry points before reading implementation details:
ast-grep outline <file>
ast-grep outline <file> --items imports
ast-grep outline <file> --items exportsMap an unfamiliar directory. Scan the public surface of a subtree, then narrow by symbol type when you know what you are looking for:
ast-grep outline <dir> --items exports
ast-grep outline <dir> --type struct,enum,functionZoom into a known symbol. After search finds a likely name, list its members with line numbers instead of reading the whole body:
ast-grep outline <file> --match <symbol> --type class --view expandedTrace dependency direction. Find which files import a package or module to decide where a change belongs:
ast-grep outline <dir> --items imports --view signaturesReview changed files after editing. Git tells you what changed; outline summarizes the resulting structure and public surface:
ast-grep outline $(git diff --name-only HEAD) --items exportsShow full SKILL.md (192 more words)Show less
Argument Guide
--items <KIND>selects top-level items:structurefor local declarations (file default),exportsfor public API (directory default),importsfor dependencies,allwhen import/export edges matter together.--view <VIEW>controls detail, from least to most:namesfor directory scans,signaturesfor one line per item,digestfor signatures plus member names,expandedfor one line per member with its line number.--match <REGEX>filters top-level items by name or signature. Rust regex, case-sensitive; it never matches members.--type <TYPE[,TYPE...]>keeps only some top-level symbol types, such as--type class,function. Member types likemethod,fieldnever match top-level items.--pub-membershides private members when the view prints members.--json=streamemits one JSON object per file with precise ranges. Use it only to pipe or post-process entries; prefer text for navigation.
Limits
outline shows local syntax structure. It does not resolve references, infer
types, follow re-export chains, or build a call graph. Use ast-grep run,
rg, or compiler-backed tools for those questions, then outline the candidate
files they surface.
NodeTool notes
Vendored from https://github.com/ast-grep/agent-skill @ c2a9bc1 (2026-07-03).
Run via npx --yes --package @ast-grep/cli ast-grep outline <args> (bare
npx @ast-grep/cli fails — the binary is named ast-grep).
© nodetool-ai, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .agents/skills/ast-grep-outline of nodetool-ai/nodetool.
Open the folder on GitHubat commit 339f069
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in nodetool-ai/nodetool, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Ast Grep Outline next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Ast Grep Outline this skillnodetool-ai/nodetool | 560 | 1 repos | ~845 | Automated safety check: Pass | AGPL-3.0 | |
| ast-grep Structural Searchcode-yeongyu/oh-my-openagent | 70k | — | ~3.3k | Automated safety check: Pass | MIT | |
| Ast Grepccusage/ccusage | 19k | — | ~296 | Automated safety check: Pass | Custom licence | |
| Ast Grep Findparcadei/Continuous-Claude-v3 | 3.9k | 1 repos | ~677 | Automated safety check: Notes | MIT | |
| Importasgeirtj/system_prompts_leaks | 69k | — | ~3.5k | Automated safety check: Pass | CC0-1.0 | |
| Structural Code Search with ast-grepwarp-drive-data/warp-drive | 3.2k | 6 repos | ~2.4k | Automated safety check: Pass | MIT |
Similar skills
Ast Grep
ccusage/ccusage
Guides ccusage structural code searches with ast-grep. An agent skill from ccusage/ccusage.
Ast Grep Find
parcadei/Continuous-Claude-v3
AST-based code search and refactoring via ast-grep MCP. An agent skill from parcadei/Continuous-Claude-v3.
Import
asgeirtj/system_prompts_leaks
Handle explicit /import requests for read-only transcript recovery and a resume checkpoint, or continue work from other coding agents and unnamed artifacts.
Structural Code Search with ast-grep
warp-drive-data/warp-drive
Turns natural-language code queries into ast-grep rules for structural search, testing each rule against an example file before running it on a codebase.
Ast Grep
BiFangKNT/mtga
Write and debug ast-grep rules for structural code search and rewrite.
More from nodetool-ai/nodetool
All 127 skills in this repoBeat Sync Editing
nodetool-ai/nodetool
Cut a NodeTool timeline to music and shape its pacing — detect the beat grid, place cuts on phrases, pick a cut type, build speed ramps with time remap, and give the piece an arc.
Caption Titles
nodetool-ai/nodetool
Add and animate a consistent text layer on an existing NodeTool timeline.
Color Motion
nodetool-ai/nodetool
Choose and animate colour on a NodeTool timeline, including shape and text gradients, colour grades, 3D LUTs, and dither.
Commercial Beat Sheet
nodetool-ai/nodetool
Write a shootable, precisely timed commercial beat sheet and store it as a NodeTool storyboard, with a consistent entity roster behind every shot.
Elevenlabs Audio Prompting
nodetool-ai/nodetool
Direct ElevenLabs speech, dialogue, sound effects and music — the bracketed audio tags v3 acts on and why the voice decides whether a tag lands, stability as the delivery dial, punctuation instead…
Frame Composition
nodetool-ai/nodetool
Stage the frame on a NodeTool timeline — grids, focal placement, safe areas per aspect ratio, depth layers and parallax, camera moves, and where elements enter and leave.
Questions about Ast Grep Outline
What does Ast Grep Outline do?
Map file structure, imports, exports, and direct members with ast-grep before reading selected source. Ast Grep Outline is an agent skill from nodetool-ai/nodetool. Map file structure, imports, exports, and direct members with ast-grep before reading selected source.
How do I install Ast Grep Outline in Claude Code?
Run `npx skills add nodetool-ai/nodetool --skill ast-grep-outline -a claude-code`. Or copy the skill folder (.agents/skills/ast-grep-outline in nodetool-ai/nodetool) into .claude/skills/ast-grep-outline in your project. Claude Code loads it when a task matches its description.
How do I install Ast Grep Outline in Codex?
Run `npx skills add nodetool-ai/nodetool --skill ast-grep-outline -a codex`. Or copy the skill folder (.agents/skills/ast-grep-outline in nodetool-ai/nodetool) into .agents/skills/ast-grep-outline in your project. Codex loads it when a task matches its description.
Can I use Ast Grep Outline in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nodetool-ai/nodetool --skill ast-grep-outline -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ast-grep-outline, .gemini/skills/ast-grep-outline, .github/skills/ast-grep-outline and .opencode/skills/ast-grep-outline in your project.
What does Ast Grep Outline need to run?
Going by SKILL.md and its folder, Ast Grep Outline needs the command-line tools its instructions call (npx and git). Our summary lists: Node.js.
Does Ast Grep Outline access the network?
SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.
Is Ast Grep Outline safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Ast Grep Outline use?
Ast Grep Outline is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Ast Grep Outline use?
About 845 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Ast Grep Outline?
Skills that share tags, products or a category with Ast Grep Outline: ast-grep Structural Search (code-yeongyu/oh-my-openagent, 70k stars), Ast Grep (ccusage/ccusage, 19k stars), Ast Grep Find (parcadei/Continuous-Claude-v3, 3.9k stars) and Import (asgeirtj/system_prompts_leaks, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Ast Grep Outline?
nodetool-ai (a GitHub organization) maintains it in nodetool-ai/nodetool, which has 560 GitHub stars. The repository holds 127 skills in this directory. The repository was last updated on October 10, 2026.
Source: nodetool-ai/nodetool on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.