Agent skill

Hai Ast Grep

by hylarucoder in hylarucoder/hai-stack

Produces a ready-to-run ast-grep command or reusable YAML lint/codemod rule, validated against positive and negative fixtures.

Custom licenceAuto-check passedDevelopment

Install Hai Ast Grep

skills CLI
$ npx skills add hylarucoder/hai-stack --skill hai-ast-grep -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hylarucoder/hai-stack hai-ast-grep --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hylarucoder/hai-stack.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hai-ast-grep .claude/skills/hai-ast-grep && rm -rf skills-src

Use ~/.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/

Facts

Skill name
hai-ast-grep
GitHub stars
383
Token cost
~1.5k tokens
SKILL.md length
654 words
Files
6 (incl. references)
Skills in repo
18
Repo updated
First seen
Licence
Custom licence

At a glance

Produces a ready-to-run ast-grep command or reusable YAML lint/codemod rule, validated against positive and negative fixtures.

  • Works in 6 steps: Explore the pattern via CLI before… → Write the rule file (.yml) — start with… → Validate against a POSITIVE fixture —… → …
  • Rewrite depends on syntax structure: finding all call shapes
  • SKILL.md covers Project Configuration, Everyday CLI Usage (no rule…, Rule Workflow and Syntax references, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hai Ast Grep is an agent skill from hylarucoder/hai-stack. Produces a ready-to-run ast-grep command or reusable YAML lint/codemod rule, validated against positive and negative fixtures. Use when search or rewrite depends on syntax structure: finding all call shapes, avoiding regex matches in comments/strings, batch-changing signatures, or enforcing a structural rule(结构化搜索、批量改写、写 lint 规则). Do not use for plain-text replacement or type-semantic refactors that require a compiler/type checker.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `SKILL.zh_CN.md`, `references/common-patterns.md` and `references/output-template.md`).

It sits in Development, covering Linting and formatting, Code migrations and Refactoring.

When your agent uses it

  • Rewrite depends on syntax structure: finding all call shapes
  • Avoiding regex matches in comments/strings
  • Batch-changing signatures
  • Enforcing a structural rule(结构化搜索、批量改写、写 lint 规则)

Example prompts

  • “Use the hai-ast-grep skill to produce a ready-to-run ast-grep command or reusable YAML lint/codemod rule, validated against positive and negative…”
  • “/hai-ast-grep”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Explore the pattern via CLI before writing YAML
  2. Write the rule file (.yml) — start with the lint form (pattern + message + severity).
  3. Validate against a POSITIVE fixture — code that should match: ast-grep scan -r rule.yml fixtures/. Confirm it matches.
  4. Validate against a NEGATIVE fixture — code that looks similar but should NOT match. If it matches, you have a false positive: add…
  5. Add fix: only if a mechanical rewrite is wanted, then dry-run before --update-all.
  6. Deliver using the deliverable shape below (and references/output-template.md) — never hand back a bare YAML block.

What it can do on your machine

Read from SKILL.md and the folder at commit a6c7ed2. 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 (its code samples are bash and yaml).

    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

Hai Ast Grep loads about 1.5k tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 112 tokens; SKILL.md has 654 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~112
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.4k

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 654 words (~1,535 tokens).

“ast-grep uses tree-sitter to parse code into AST, enabling precise pattern matching. Reach for it whenever a search or refactor depends on syntax structure: one-off searches and rewrites run straight from the CLI, reusable lint/codemod rules are written in YAML…”

— opening of SKILL.md by hylarucoder, Custom licence
name
hai-ast-grep

Read the full SKILL.md on GitHub

Files

SKILL.md and 5 other files (references) in skills/hai-ast-grep of hylarucoder/hai-stack.

  • SKILL.md
  • SKILL.zh_CN.md
  • references/common-patterns.md
  • references/output-template.md
  • references/project-setup.md
  • references/rule-syntax.md

Open the folder on GitHubat commit a6c7ed2

Compare with similar skills

Hai Ast Grep 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.

Hai Ast Grep compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hai Ast Grep this skillhylarucoder/hai-stack383—~1.5kAutomated safety check: PassCustom licence
Migrate Core Code to Submodulestinyhumansai/openhuman42k—~2.6kAutomated safety check: PassGPL-3.0
ast-grep Structural Searchcode-yeongyu/oh-my-openagent70k—~3.3kAutomated safety check: PassMIT
Rust Best Practicesfarm-fe/farm5.6k3 repos~1.1kAutomated safety check: PassMIT
File Good First BugBrowserWorks/waterfox-android3792 repos~2kAutomated safety check: PassCustom licence
ast-grep Codemod Referencewarp-drive-data/warp-drive3.2k—~2.6kAutomated safety check: PassMIT

Similar skills

  • 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.

    42k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • 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.

    70k GitHub stars~3.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Guide for writing idiomatic Rust code based on Apollo GraphQL's best practices handbook.

    5.6k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • File Good First Bug

    BrowserWorks/waterfox-android

    A skill your agent uses when the user wants to file good-first-bugs in Bugzilla for Firefox.

    379 GitHub starsUsed in 2 repos~2k tokens
    DevelopmentAuto-check passed
  • ast-grep Codemod Reference

    warp-drive-data/warp-drive

    Reference for writing and debugging TypeScript and JavaScript codemods with @ast-grep/napi: parsing, node queries, meta-variables, rule objects and editing.

    3.2k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Unslop Code

    JCarterJohnson/vibecoded-design-tells

    Strips the tells that make source code read as AI-generated and forces code that fits the project instead of the model's default average.

    513 GitHub stars~2.5k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed

More from hylarucoder/hai-stack

All 18 skills in this repo
  • Verify a defined software change against requirements and produce a proportional, evidence-backed acceptance report with specification precedence, scope boundaries, requirement-to-evidence…

    383 GitHub stars~2.1k tokensUpdated 4 days ago
    Auto-check passed
  • Readme Beautifier

    hylarucoder/hai-stack

    Reformats and restructures a README or similar Markdown project document without changing its factual content, voice, or scope, then summarizes formatting-only edits.

    383 GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed
  • Hai Visual Explainer

    hylarucoder/hai-stack

    Turns supplied content into self-contained HTML and PNG in two modes: card for one shareable frame(知识卡、信息卡、金句卡、封面、把要点做成一张图), report for multi-section documents(可视化报告、HTML 汇报页、PRD/计划/评审做成网页).

    383 GitHub stars~2k tokensUpdated 4 days ago
    Auto-check passed
  • Code Review And Quality

    hylarucoder/hai-stack

    Reviews a code change for correctness, security, maintainability, architecture, performance, and verification gaps, or performs a local code-smell review.

    383 GitHub stars~934 tokensUpdated 4 days ago
    Auto-check passed
  • Entity Model Auditor

    hylarucoder/hai-stack

    Audits an entity model field by field: what should exist, what exists now, where each value belongs (column, config, computed runtime value, or removal), and what must migrate.

    383 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • Geju

    hylarucoder/hai-stack

    Challenges an overly conservative, incremental, or compatibility-led proposal with a bold target model, a concrete kill/merge/split list, materially different options, and a falsifiable first proof…

    383 GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed

Categories

Questions about Hai Ast Grep

What does Hai Ast Grep do?

Produces a ready-to-run ast-grep command or reusable YAML lint/codemod rule, validated against positive and negative fixtures. Hai Ast Grep is an agent skill from hylarucoder/hai-stack. Produces a ready-to-run ast-grep command or reusable YAML lint/codemod rule, validated against positive and negative fixtures.

When should I use Hai Ast Grep?

Hai Ast Grep fits situations like: rewrite depends on syntax structure: finding all call shapes; avoiding regex matches in comments/strings; batch-changing signatures; enforcing a structural rule(结构化搜索、批量改写、写 lint 规则).

How do I install Hai Ast Grep in Claude Code?

Run `npx skills add hylarucoder/hai-stack --skill hai-ast-grep -a claude-code`. Or copy the skill folder (skills/hai-ast-grep in hylarucoder/hai-stack) into .claude/skills/hai-ast-grep in your project. Claude Code loads it when a task matches its description.

How do I install Hai Ast Grep in Codex?

Run `npx skills add hylarucoder/hai-stack --skill hai-ast-grep -a codex`. Or copy the skill folder (skills/hai-ast-grep in hylarucoder/hai-stack) into .agents/skills/hai-ast-grep in your project. Codex loads it when a task matches its description.

Can I use Hai Ast Grep 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 hylarucoder/hai-stack --skill hai-ast-grep -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hai-ast-grep, .gemini/skills/hai-ast-grep, .github/skills/hai-ast-grep and .opencode/skills/hai-ast-grep in your project.

What does Hai Ast Grep need to run?

SKILL.md names no scripts, command-line tools or credentials: Hai Ast Grep is instructions for the agent only.

Does Hai Ast Grep 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 Hai Ast Grep 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 Hai Ast Grep use?

Hai Ast Grep has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Hai Ast Grep use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.9k tokens, read only when the agent opens those files.

What are the alternatives to Hai Ast Grep?

Skills that share tags, products or a category with Hai Ast Grep: Migrate Core Code to Submodules (tinyhumansai/openhuman, 42k stars), ast-grep Structural Search (code-yeongyu/oh-my-openagent, 70k stars), Rust Best Practices (farm-fe/farm, 5.6k stars) and File Good First Bug (BrowserWorks/waterfox-android, 379 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hai Ast Grep?

hylarucoder (a GitHub user) maintains it in hylarucoder/hai-stack, which has 383 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 5, 2026.

Source: hylarucoder/hai-stack on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.