ast-grep SKILL.md skillB

ast-grep from vinhnx/vtcode is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add vinhnx/vtcode/ast-grep@git:20261002.dca67ae

Pins git:20261002.dca67ae in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
vinhnx/vtcode
Path
crates/codegen/vtcode-skills/src/skills/assets/samples/ast-grep/SKILL.md
Versions recorded
2
Latest version
git:20261002.dca67ae, committed Oct 2, 2026
First version recorded
Jul 17, 2026
Size
102,657 bytes
Repository stars
897
License
Apache-2.0

Use for ast-grep project setup, rule authoring, rule debugging, and structural search workflows.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Ast-Grep

Use this skill for ast-grep project setup, rule authoring, rule debugging, and CLI workflows that go beyond a single
structural query.

## Routing

- Use `exec_command` for ast-grep queries, project scans, rule tests, debug output, and rewrite previews.
- Use `ast-grep scan` for project rules and `ast-grep test` for rule tests.
- Use `ast-grep run --pattern=... --rewrite=... --json=compact --color=never` for dry-run rewrite previews. Review every
  replacement before applying changes.
- Use `ast-grep run --debug-query` when a query matches an unexpected syntax node.
- Use `--kind` to match node kinds. Ast-grep supports ESQuery-style compound selectors and pseudo-selectors in supported
  releases.
- Keep this skill read-only unless the user explicitly authorises applying a rewrite.

## Quick Start

- In VT Code, prefer `vtcode dependencies install ast-grep` before suggesting system package managers.
- External install routes such as Homebrew, Cargo, npm, pip, MacPorts, or Nix are fallback options when the user
  explicitly wants a system-managed install.
- After installation, validate availability with `ast-grep --help`.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add vinhnx/vtcode/ast-grep@sha256:735655cecde483ae

The line at the top of this page pins the label git:20261002.dca67ae, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mlhabszgr2yeimrd.svg)](https://markdownregistry.com/a/art_mlhabszgr2yeimrd)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Jul 17, 2026 and Oct 2, 2026, about one every 77 days.

versioncommittedcommitsizeaudit
git:20261002.dca67ae latest2026-10-02 dca67ae 102,657 BB view · diff
git:20260717.d3b2d892026-07-17 d3b2d89 101,762 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No script tag (matched: <script)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (102657 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

vinhnx/vtcode · 897 stars · license Apache-2.0 · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mlhabszgr2yeimrd
GET https://markdownregistry.com/api/v1/resolve?ref=vinhnx/vtcode/ast-grep
GET https://markdownregistry.com/api/v1/blob/735655cecde483ae11ef049fe77c17aaba6406cdafda2b2eca396b42456df77e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from vinhnx/vtcode

AGENTS.md@.agents/skills/rust-skills AGENTS.md file
vinhnx/vtcode · .agents/skills/rust-skills/AGENTS.md · 193 Rust coding rules across 14 categories. Use when writing, reviewing, or refactoring Rust code. Covers ownership…
v1.1.0 · audit A · 897 stars
CLAUDE.md@.agents/skills/rust-skills CLAUDE.md file
vinhnx/vtcode · .agents/skills/rust-skills/CLAUDE.md · Comprehensive Rust coding guidelines with 179 rules across 14 categories. Use when writing, reviewing, or refactoring…
v1.0.0 · audit A · 897 stars
rust-skills SKILL.md skill
vinhnx/vtcode · .agents/skills/rust-skills/SKILL.md · 193 Rust coding rules across 14 categories. Use when writing, reviewing, or refactoring Rust code. Covers ownership…
v1.1.0 · audit A · 897 stars
AGENTS.md AGENTS.md file
vinhnx/vtcode · AGENTS.md
git:20261101.59edae7 · audit A · 897 stars
AGENTS.md@apps/webmcp AGENTS.md file
vinhnx/vtcode · apps/webmcp/AGENTS.md
git:20261017.ecc4cf9 · audit A · 897 stars
AGENTS.md@crates/codegen/vtcode-a2a AGENTS.md file
vinhnx/vtcode · crates/codegen/vtcode-a2a/AGENTS.md
git:20261006.4f7011b · audit A · 897 stars
AGENTS.md@crates/codegen/vtcode-acp AGENTS.md file
vinhnx/vtcode · crates/codegen/vtcode-acp/AGENTS.md
git:20261029.fd58541 · audit A · 897 stars
AGENTS.md@crates/codegen/vtcode-auth AGENTS.md file
vinhnx/vtcode · crates/codegen/vtcode-auth/AGENTS.md
git:20261029.fd58541 · audit A · 897 stars
AGENTS.md@crates/codegen/vtcode-bash-runner AGENTS.md file
vinhnx/vtcode · crates/codegen/vtcode-bash-runner/AGENTS.md
git:20261029.fd58541 · audit A · 897 stars
AGENTS.md@crates/codegen/vtcode-config AGENTS.md file
vinhnx/vtcode · crates/codegen/vtcode-config/AGENTS.md
git:20261103.35a8d85 · audit A · 897 stars
AGENTS.md@crates/codegen/vtcode-core AGENTS.md file
vinhnx/vtcode · crates/codegen/vtcode-core/AGENTS.md
git:20261103.35a8d85 · audit A · 897 stars
AGENTS.md@crates/codegen/vtcode-desktop AGENTS.md file
vinhnx/vtcode · crates/codegen/vtcode-desktop/AGENTS.md
git:20261103.983ccd9 · audit A · 897 stars

Every file in vinhnx/vtcode

Other files named ast-grep

ast-grep SKILL.md skill
code-yeongyu/oh-my-openagent · packages/shared-skills/skills/ast-grep/SKILL.md · Searches and rewrites code by AST shape across 25 languages. Use when the target is a syntax pattern (every…
git:20260914.52f863d · audit A · 70,648 stars
ast-grep SKILL.md skill
ast-grep/agent-skill · ast-grep/skills/ast-grep/SKILL.md · Guide for writing ast-grep rules to perform structural code search and analysis. Use when users need to search…
git:20260909.affe2b9 · audit A · 900 stars
ast-grep SKILL.md skill
moeru-ai/auv · .agents/skills/ast-grep/SKILL.md · Guide for writing ast-grep rules to perform structural code search and analysis. Use when users need to search…
git:20260725.0b88df9 · audit A · 198 stars
ast-grep SKILL.md skill
outlinedriven/outline-driven-development · .devin/skills/ast-grep/SKILL.md · Use when asked to run AST-based structural search, lint, or rewrite of code when regex is too fragile. Not for remote…
git:20260905.1f63894 · audit A · 56 stars
ast-grep SKILL.md skill
outlinedriven/odin-claude-plugin · plugins/odin-code/skills/ast-grep/SKILL.md · Use when asked to run AST-based structural search, lint, or rewrite of code when regex is too fragile. Not for remote…
git:20260904.2014e73 · audit A · 40 stars
ast-grep SKILL.md skill
codeatcode/oss-ai-skills · tool/ast-grep/SKILL.md · Use when doing structural code search and rewriting - ast-grep linting, refactoring, multi-language patterns
v1.0.1 · audit A · 28 stars
ast-grep SKILL.md skill
everruns/yolop · src/bundled/system-skills/ast-grep/SKILL.md · Write effective ast-grep patterns for the built-in `ast_grep` structural-search tool and `ast_edit` rewrites. Use when…
git:20260816.37187ba · audit A · 17 stars
ast-grep SKILL.md skill
sparq-org/sparq · .claude/skills/ast-grep/SKILL.md · Understand code STRUCTURE without reading whole files — outline a large file to its signatures, structural-grep every…
git:20261005.afb6bad · audit A · 13 stars

Browse by kind, by grade B, or by owner.