Migrate Core Code to Submodules
tinyhumansai/openhuman
Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.
Structural search and rewrite with the astgrep and astedit tools.
Install Structural Edits
$ npx skills add Zfinix/aster --skill structural-edits -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Zfinix/aster structural-edits --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/Zfinix/aster.git skills-src && mkdir -p .claude/skills && cp -r skills-src/crates/aster-skills/builtins/internal/structural-edits .claude/skills/structural-edits && 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 "structural-edits" agent skill from https://github.com/Zfinix/aster/tree/main/crates/aster-skills/builtins/internal/structural-edits into .claude/skills/structural-edits/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "structural-edits", 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/Zfinix/aster/tree/main/crates/aster-skills/builtins/internal/structural-editsType 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 Zfinix/aster --skill structural-edits -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Zfinix/aster structural-edits --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Zfinix/aster.git skills-src && mkdir -p .agents/skills && cp -r skills-src/crates/aster-skills/builtins/internal/structural-edits .agents/skills/structural-edits && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "structural-edits" agent skill from https://github.com/Zfinix/aster/tree/main/crates/aster-skills/builtins/internal/structural-edits into .agents/skills/structural-edits/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "structural-edits", 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 Zfinix/aster --skill structural-edits -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Zfinix/aster structural-edits --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Zfinix/aster.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/crates/aster-skills/builtins/internal/structural-edits .cursor/skills/structural-edits && 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 "structural-edits" agent skill from https://github.com/Zfinix/aster/tree/main/crates/aster-skills/builtins/internal/structural-edits into .cursor/skills/structural-edits/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "structural-edits", 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/Zfinix/aster.git --path crates/aster-skills/builtins/internal/structural-edits--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 Zfinix/aster --skill structural-edits -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Zfinix/aster structural-edits --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Zfinix/aster.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/crates/aster-skills/builtins/internal/structural-edits .gemini/skills/structural-edits && 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 "structural-edits" agent skill from https://github.com/Zfinix/aster/tree/main/crates/aster-skills/builtins/internal/structural-edits into .gemini/skills/structural-edits/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "structural-edits", 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 Zfinix/aster structural-editsInstalls 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 Zfinix/aster --skill structural-edits -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Zfinix/aster.git skills-src && mkdir -p .github/skills && cp -r skills-src/crates/aster-skills/builtins/internal/structural-edits .github/skills/structural-edits && 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 "structural-edits" agent skill from https://github.com/Zfinix/aster/tree/main/crates/aster-skills/builtins/internal/structural-edits into .github/skills/structural-edits/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "structural-edits", 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 Zfinix/aster --skill structural-edits -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Zfinix/aster structural-edits --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Zfinix/aster.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/crates/aster-skills/builtins/internal/structural-edits .opencode/skills/structural-edits && 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 "structural-edits" agent skill from https://github.com/Zfinix/aster/tree/main/crates/aster-skills/builtins/internal/structural-edits into .opencode/skills/structural-edits/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "structural-edits", 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
structural-edits- GitHub stars
- 112
- Token cost
- ~537 tokens
- SKILL.md length
- 295 words
- Files
- 1
- Skills in repo
- 19
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Structural search and rewrite with the astgrep and astedit tools.
- Works in 7 steps: ast_grep over search_files when syntax… → ast_edit over repeated edit_file when… → Metavariables carry the capture. $X… → …
- The same pattern appears in many places
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Text search matches comments
What it does
Structural Edits is an agent skill from Zfinix/aster. Structural search and rewrite with the astgrep and astedit tools. Use when the same pattern appears in many places, when text search matches comments or strings, or when a rename or codemod spans multiple files.
Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Code migrations. The repository describes itself as: An open-source agent harness for software work. The licence is Apache-2.0.
When your agent uses it
- The same pattern appears in many places
- Text search matches comments
- Codemod spans multiple files
Example prompts
- “/structural-edits”
Workflow steps
7 steps, taken from the first numbered list in SKILL.md.
- ast_grep over search_files when syntax matters. ast_grep with a
- ast_edit over repeated edit_file when the same change repeats. One
- Metavariables carry the capture. $X captures a single node,
- Patterns must parse as the target language. A pattern that is not
- Patterns exclude trailing semicolons. A pattern for dbg!($X)
- Run ast_grep first when unsure. A dry search with the same pattern
- Read the diff at approval time. A too-broad pattern rewrites code you
What it can do on your machine
Read from SKILL.md and the folder at commit 3fbb67c. 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
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
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
Structural Edits loads about 537 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 295 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 Zfinix/aster at commit 3fbb67c, republished under its Apache-2.0 licence (© Zfinix). 295 words, ~537 tokens.
Download SKILL.mdSave it as
.claude/skills/structural-edits/SKILL.md (or your agent's skills folder).- name
- structural-edits
- description
- Structural search and rewrite with the ast_grep and ast_edit tools. Use when the same pattern appears in many places, when text search matches comments or strings, or when a rename or codemod spans multiple files.
Structural edits
- ast_grep over search_files when syntax matters.
ast_grepwith a pattern likedbg!($X)orfn $NAME($$$ARGS)matches real code, not comments or string literals. Plain text search is fine for identifiers that appear nowhere else. Scope withpathto one directory when the change is local. - ast_edit over repeated edit_file when the same change repeats. One
pattern plus rewrite applies everywhere at once and returns a diff.
Three or more identical edits means ast_edit; one or two means edit_file.
Example: pattern
dbg!($X)with rewriteeprintln!("{:?}", $X)removes every debug print in the scope in one approval. - Metavariables carry the capture.
$Xcaptures a single node,$$$ARGScaptures a list. Reuse the same name in the rewrite; a name that appears only in the rewrite is an error, not an insertion. - Patterns must parse as the target language. A pattern that is not
valid syntax in the file's language matches nothing, silently. Write the
pattern in the language you are editing, and keep it narrow with context
(
$OBJ.foo($$$ARGS)rather thanfoo($$$ARGS)) so unrelated calls do not match. - Patterns exclude trailing semicolons. A pattern for
dbg!($X)matches the call, not the;after it. Do not put a semicolon in the pattern or the rewrite unless the statement itself is the target. - Run ast_grep first when unsure. A dry search with the same pattern shows exactly what ast_edit would touch, with no approval needed. If the match list surprises you, fix the pattern before rewriting.
- Read the diff at approval time. A too-broad pattern rewrites code you did not intend, and the diff is the only place you will see that. Every changed file goes through the same approval as edit_file; a Deny on one file stops the whole batch.
© Zfinix, Apache-2.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 crates/aster-skills/builtins/internal/structural-edits of Zfinix/aster.
Open the folder on GitHubat commit 3fbb67c
Compare with similar skills
Structural Edits 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 |
|---|---|---|---|---|---|---|
| Structural Edits this skillZfinix/aster | 112 | — | ~537 | Automated safety check: Pass | Apache-2.0 | |
| Migrate Core Code to Submodulestinyhumansai/openhuman | 42k | — | ~2.6k | Automated safety check: Pass | GPL-3.0 | |
| Migrate Internal Package into GhostTryGhost/Ghost | 55k | — | ~3.8k | Automated safety check: Pass | MIT | |
| Next Cache Components Adoptionvercel/next.js | 143k | 6 repos | ~8.3k | Automated safety check: Pass | MIT | |
| Deprecate R Functions and Argumentstidyverse/dplyr | 5.1k | 1 repos | ~1.2k | Automated safety check: Pass | Custom licence | |
| Rust Path Typesopeninterpreter/openinterpreter | 69k | 2 repos | ~605 | Automated safety check: Pass | Apache-2.0 |
Similar skills
Migrate Internal Package into Ghost
TryGhost/Ghost
Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.
- Official
Next Cache Components Adoption
vercel/next.js
Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces.
Deprecate R Functions and Arguments
tidyverse/dplyr
Walks through deprecating an R function or argument in a package: lifecycle warning, silenced tests, a new snapshot test, documentation badge and NEWS entry.
Rust Path Types
openinterpreter/openinterpreter
Rules for choosing Rust types for filesystem paths in new Codex code, covering protocol types, internal use and model tool arguments.
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.
More from Zfinix/aster
All 19 skills in this repoArtifact Design
Zfinix/aster
Designing and building any user-facing surface: a web page, landing page, dashboard, report, HTML document, email, or a component inside an existing app.
Aster Chat Sessions
Zfinix/aster
Drive aster chat programmatically and manage sessions and memory: one-shot --print/--json answers, --messages-json for caller-owned history, --continue and --session persistence, --allow-edits…
Aster CLI
Zfinix/aster
Guidance for using the aster CLI to work in a codebase with an AI agent: chat and edit code, run AI code reviews, apply fixes, and manage sessions, memory, and skills.
Aster Config
Zfinix/aster
Reference for aster.yaml, covering review models, analyzers, focus areas, include/exclude globs, minconfidence, and the permissions block that gates edits.
Aster Fix Workflow
Zfinix/aster
Pipe aster review findings into aster fix to generate and apply patches safely, using review --json, fix --findings-json, dry-run inspection, --apply, and permission gating.
Aster Planning
Zfinix/aster
Create and execute structured plans for multi-step tasks. An agent skill from Zfinix/aster.
Related
Categories
Questions about Structural Edits
What does Structural Edits do?
Structural search and rewrite with the astgrep and astedit tools. Structural Edits is an agent skill from Zfinix/aster. Structural search and rewrite with the astgrep and astedit tools.
When should I use Structural Edits?
Structural Edits fits situations like: the same pattern appears in many places; text search matches comments; codemod spans multiple files.
How do I install Structural Edits in Claude Code?
Run `npx skills add Zfinix/aster --skill structural-edits -a claude-code`. Or copy the skill folder (crates/aster-skills/builtins/internal/structural-edits in Zfinix/aster) into .claude/skills/structural-edits in your project. Claude Code loads it when a task matches its description.
How do I install Structural Edits in Codex?
Run `npx skills add Zfinix/aster --skill structural-edits -a codex`. Or copy the skill folder (crates/aster-skills/builtins/internal/structural-edits in Zfinix/aster) into .agents/skills/structural-edits in your project. Codex loads it when a task matches its description.
Can I use Structural Edits 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 Zfinix/aster --skill structural-edits -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/structural-edits, .gemini/skills/structural-edits, .github/skills/structural-edits and .opencode/skills/structural-edits in your project.
What does Structural Edits need to run?
SKILL.md names no scripts, command-line tools or credentials: Structural Edits is instructions for the agent only.
Does Structural Edits access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Structural Edits 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 Structural Edits use?
Structural Edits is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Structural Edits use?
About 537 tokens (SKILL.md is roughly 2.1k 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 Structural Edits?
Skills that share tags, products or a category with Structural Edits: Migrate Core Code to Submodules (tinyhumansai/openhuman, 42k stars), Migrate Internal Package into Ghost (TryGhost/Ghost, 55k stars), Next Cache Components Adoption (vercel/next.js, 143k stars) and Deprecate R Functions and Arguments (tidyverse/dplyr, 5.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Structural Edits?
Zfinix (a GitHub user) maintains it in Zfinix/aster, which has 112 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 6, 2026.
Source: Zfinix/aster on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.