ast-grep SKILL.md skillA

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

Install it, pinned
mdr add everruns/yolop/ast-grep@git:20260816.37187ba

Pins git:20260816.37187ba in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
everruns/yolop
Path
src/bundled/system-skills/ast-grep/SKILL.md
Versions recorded
3
Latest version
git:20260816.37187ba, committed Aug 16, 2026
First version recorded
Jul 4, 2026
Size
6,437 bytes
Repository stars
18
License
MIT

Write effective ast-grep patterns for the built-in `ast_grep` structural-search tool and `ast_edit` rewrites. Use when searching or refactoring code by shape rather than text, call expressions, function/struct declarations, wrappers, imports, or when a pattern returns nothing or the wrong nodes.

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 structural search and rewrite

Yolop ships built-in `ast_grep` (read-only search, default harness) and `ast_edit`
(pattern/replacement rewrites, opt-in via `[[capabilities]] ref = "ast_edit"` in
`settings.toml`) backed by the `ast-grep` engine compiled into the binary. This is **not** the
`sg` command-line tool, there is no `sg run`/`sg scan`, no rule YAML files, and no
`--rewrite` CLI. Drive the tools directly with their arguments.

## When to reach for it

Use `ast_grep` for code **shapes**, after `repo_map`/`grep_files` have narrowed
the area:

- Call sites of a function regardless of receiver or arguments.
- Declarations: functions, structs, classes, impls, interfaces.
- Wrappers and idioms: `unwrap()`, `try/except`, specific decorators/attributes.
- Anywhere lexical search drowns in comments, strings, or false matches.

Use `ast_edit` when the same ast-grep pattern should be **rewritten** everywhere it
matches, rename a call shape, swap an import path, delete a wrapper, modernize an
idiom. Always confirm the pattern with `ast_grep` first, then preview with `ast_edit`
before applying.

Prefer `grep_files` for exact text, identifiers, log strings, or non-code files.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add everruns/yolop/ast-grep@sha256:2ba87dcf02e30338

The line at the top of this page pins the label git:20260816.37187ba, 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_yvksz6th7mj4gxc3.svg)](https://markdownregistry.com/a/art_yvksz6th7mj4gxc3)

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

Versions

The registry has recorded 3 versions of this file, between Jul 4, 2026 and Aug 16, 2026, about one every 22 days.

versioncommittedcommitsizeaudit
git:20260816.37187ba latest2026-08-16 37187ba 6,437 BA view · diff
git:20260711.e1c78db2026-07-11 e1c78db 6,464 BA view · diff
git:20260704.986b6be2026-07-04 986b6be 5,120 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6437 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
  • pass: No script tag

Source

GitHub

everruns/yolop · 18 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_yvksz6th7mj4gxc3
GET https://markdownregistry.com/api/v1/resolve?ref=everruns/yolop/ast-grep
GET https://markdownregistry.com/api/v1/blob/2ba87dcf02e3033838745e0ac9a526407b9479247d9b4862c8d74ac0052a6c45

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 everruns/yolop

author-extension SKILL.md skill
everruns/yolop · .agents/skills/author-extension/SKILL.md · Write a new yolop extension end-to-end — scaffold, implement, install, verify, and enable it — when the user asks yolop…
git:20260724.8351b7d · audit A · 18 stars
maintenance SKILL.md skill
everruns/yolop · .agents/skills/maintenance/SKILL.md · Goal-oriented repository maintenance and release-readiness work for yolop. Use when the user asks for maintenance…
git:20260914.ff8c41f · audit A · 18 stars
release SKILL.md skill
everruns/yolop · .agents/skills/release/SKILL.md · Cut a new yolop release. Prepares the release PR, runs publish-readiness checks, monitors CI publish to crates.io and…
git:20260821.a2ba836 · audit A · 18 stars
ship SKILL.md skill
everruns/yolop · .agents/skills/ship/SKILL.md · Goal-oriented workflow for landing a requested change to yolop safely. Use when the user asks to ship, fix and ship…
git:20261102.a927894 · audit A · 18 stars
AGENTS.md AGENTS.md file
everruns/yolop · AGENTS.md
git:20261012.8e76f12 · audit A · 18 stars
CLAUDE.md CLAUDE.md file
everruns/yolop · CLAUDE.md
git:20260527.04f8025 · audit B · 18 stars
joke SKILL.md skill
everruns/yolop · src/bundled/system-skills/joke/SKILL.md · Generate an original, clean joke on demand. Use when the user asks for a joke, wants something funny, or says they need…
git:20260816.37187ba · audit A · 18 stars
okf SKILL.md skill
everruns/yolop · src/bundled/system-skills/okf/SKILL.md · Read, author, maintain, and validate Open Knowledge Format (OKF v0.2) bundles, knowledge as a directory of markdown…
git:20260929.212a338 · audit A · 18 stars
skill-management SKILL.md skill
everruns/yolop · src/bundled/system-skills/skill-management/SKILL.md · Manage installed skills and the public skills.sh registry through yolop's CLI.
git:20260901.336bc79 · audit A · 18 stars
yolop-config SKILL.md skill
everruns/yolop · src/bundled/system-skills/yolop-config/SKILL.md · Manage Yolop settings, continuation budgets, persistent default model, and model catalog through the config command.
git:20261016.de6fba1 · audit A · 18 stars
yolop-hooks SKILL.md skill
everruns/yolop · src/bundled/system-skills/yolop-hooks/SKILL.md · Configure yolop lifecycle hooks with the attached CLI and scoped JSON manifests.
git:20260901.336bc79 · audit A · 18 stars
yolop SKILL.md skill
everruns/yolop · src/bundled/system-skills/yolop/SKILL.md · Built-in guide to using yolop, slash commands, keyboard shortcuts, CLI flags, tools, and session controls. Use when the…
git:20261018.59545c0 · audit A · 18 stars

Every file in everruns/yolop

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:20261104.c2cbe9b · audit A · 901 stars
ast-grep SKILL.md skill
vinhnx/vtcode · crates/codegen/vtcode-skills/src/skills/assets/samples/ast-grep/SKILL.md · Use for ast-grep project setup, rule authoring, rule debugging, and structural search workflows.
git:20261002.dca67ae · audit B · 897 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
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 A, or by owner.