Agent skill

Ast Grep Typescript React

by pproenca in pproenca/dot-skills

A skill your agent uses when writing, debugging, or reviewing ast-grep patterns, YAML rules, or codemods against TypeScript or React (.ts/.tsx) code — searching for JSX elements, props, hooks…

MITAuto-check passedFrontend & Design

Install Ast Grep Typescript React

skills CLI
$ npx skills add pproenca/dot-skills --skill ast-grep-typescript-react -a claude-code

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

GitHub CLI
$ gh skill install pproenca/dot-skills ast-grep-typescript-react --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/pproenca/dot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.experimental/ast-grep-typescript-react .claude/skills/ast-grep-typescript-react && 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
ast-grep-typescript-react
GitHub stars
214
Token cost
~1.2k tokens
SKILL.md length
458 words
Files
15 (incl. references, assets)
Skills in repo
182
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when writing, debugging, or reviewing ast-grep patterns, YAML rules, or codemods against TypeScript or React (.ts/.tsx) code — searching for JSX elements, props, hooks…

  • Works in 6 steps: Language Selection (lang) → Fragment Matching (ctx) → JSX Node Kinds (jsx) → …
  • Reviewing ast-grep patterns
  • SKILL.md covers When to Apply, First moves when a TS/React…, Rule Categories and Quick Reference, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Ast Grep Typescript React is an agent skill from pproenca/dot-skills. Use this skill when writing, debugging, or reviewing ast-grep patterns, YAML rules, or codemods against TypeScript or React (.ts/.tsx) code — searching for JSX elements, props, hooks, imports, or type constructs, and rewriting them. Covers the TS/React-specific traps — the tsx-vs-typescript language split, JSX and TypeScript node kinds, fragment matching, rewrites, and the @ast-grep/napi API. Complements the general-purpose ast-grep skill (rule mechanics) — reach for this one whenever the target code is…

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 17 other files, including reference files and assets (for example `AGENTS.md`, `assets/templates/_template.md` and `metadata.json`).

It sits in Frontend & Design, covering React components and Code migrations. It works with React and TypeScript. The repository describes itself as: A collection of AI agent skills following the Agent Skills open format. The licence is MIT.

When your agent uses it

  • Reviewing ast-grep patterns
  • Codemods against TypeScript
  • React (.ts/.tsx) code — searching for JSX elements
  • Type constructs

Example prompts

  • “/ast-grep-typescript-react”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Language Selection (lang)
  2. Fragment Matching (ctx)
  3. JSX Node Kinds (jsx)
  4. TypeScript Constructs (ts)
  5. Rewrites & Codemods (fix)
  6. Programmatic Use (napi)

What it can do on your machine

Read from SKILL.md and the folder at commit cf93c57. 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

Ast Grep Typescript React loads about 1.2k tokens when it runs, and up to ~4.9k if it reads all its reference files. Until then it costs about 139 tokens; SKILL.md has 458 words of instructions outside code blocks.

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

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 pproenca/dot-skills at commit cf93c57, republished under its MIT licence (© pproenca). 458 words, ~1,204 tokens.

Download SKILL.mdSave it as .claude/skills/ast-grep-typescript-react/SKILL.md (or your agent's skills folder). This skill also uses 14 other files; get the full folder from GitHub.
name
ast-grep-typescript-react
description
Use this skill when writing, debugging, or reviewing ast-grep patterns, YAML rules, or codemods against TypeScript or React (.ts/.tsx) code — searching for JSX elements, props, hooks, imports, or type constructs, and rewriting them. Covers the TS/React-specific traps — the tsx-vs-typescript language split, JSX and TypeScript node kinds, fragment matching, rewrites, and the @ast-grep/napi API. Complements the general-purpose ast-grep skill (rule mechanics) — reach for this one whenever the target code is TypeScript or React.

ast-grep for TypeScript & React

The wrong defaults a capable model hits when pointing ast-grep at .ts/.tsx code — mostly cases where a rule silently matches nothing because the language or a node kind was guessed wrong. This skill assumes you already know ast-grep's rule mechanics (patterns, meta-variables, all/any/has/inside, constraints); it corrects only what TypeScript and React add on top.

For general ast-grep rule-writing mechanics, use the companion ast-grep skill.

When to Apply

  • Writing an ast-grep pattern or YAML rule whose target is .ts or .tsx code
  • Searching for JSX elements, props, React hooks, imports, or TS type constructs
  • Building a codemod that rewrites JSX or TypeScript (rename a component, strip React.FC, migrate imports)
  • A rule "matches nothing" on TSX and you don't know why (usually the language or a node kind)
  • Driving ast-grep programmatically from a JS/TS script via @ast-grep/napi

First moves when a TS/React rule misbehaves

  1. Check the language. JSX-bearing files must run under tsx, never typescript. This is the single most common cause of silent no-match. See lang-tsx-for-jsx.
  2. Debug the pattern's AST. ast-grep run --pattern '<your pattern>' --lang tsx --debug-query=ast on a real snippet shows the node kinds and reveals ERROR nodes. Trust this over guessed kind names.
  3. Wrap fragments. If the pattern is an attribute, prop, or type annotation, it needs context + selector. See ctx-fragment-context-selector.

Rule Categories

#CategoryPrefixCovers
1Language Selectionlangtsx-vs-typescript split, scanning .ts + .tsx, languageGlobs
2Fragment Matchingctxcontext/selector for JSX attrs, props, type annotations
3JSX Node Kindsjsxself-closing vs paired elements, attribute-value metavariables
4TypeScript Constructststype-only imports, as casts, React.FC generics
5Rewrites & Codemodsfixre-emitting JSX metavars so children/props aren't dropped
6Programmatic Usenapi@ast-grep/napi Lang.Tsx, NapiConfig shape
Show full SKILL.md (172 more words)Show less

Quick Reference

1. Language Selection (lang)
  • lang-tsx-for-jsx — Use tsx for any JSX; typescript parses JSX as ERROR and matches nothing
  • lang-scan-ts-and-tsx — Cover both .ts and .tsx; languageGlobs for reuse (+ the <T>-cast caveat)
2. Fragment Matching (ctx)
3. JSX Node Kinds (jsx)
4. TypeScript Constructs (ts)
5. Rewrites & Codemods (fix)
6. Programmatic Use (napi)

How to Use

Read the individual reference file for the decision you're making — each is self-contained with a canonical example. references/_sections.md defines the categories; AGENTS.md is the full compiled index.

  • ast-grep — general ast-grep rule-writing mechanics (patterns, composition, constraints, testing). This skill layers TS/React specifics on top of it.

© pproenca, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 14 other files (references, assets) in skills/.experimental/ast-grep-typescript-react of pproenca/dot-skills.

  • SKILL.md
  • AGENTS.md
  • assets/templates/_template.md
  • metadata.json
  • references/_sections.md
  • references/ctx-fragment-context-selector.md
  • references/fix-jsx-rewrite-completeness.md
  • references/jsx-attribute-metavars.md
  • references/jsx-self-closing-vs-paired.md
  • references/lang-scan-ts-and-tsx.md
  • references/lang-tsx-for-jsx.md
  • references/napi-lang-tsx-findall.md
  • references/ts-as-expression-casts.md
  • references/ts-generic-react-fc.md
  • references/ts-type-only-imports.md

Open the folder on GitHubat commit cf93c57

Compare with similar skills

Ast Grep Typescript React 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.

Ast Grep Typescript React compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ast Grep Typescript React this skillpproenca/dot-skills214—~1.2kAutomated safety check: PassMIT
React Render Types CompositionHorusGoul/eslint-plugin-react-render-types111—~1.1kAutomated safety check: PassMIT
Safe Element Comparisonseasonedcc/remix-forms514—~1.8kAutomated safety check: PassMIT
Frontend Typescript Rulesshinpr/ai-coding-project-boilerplate232—~1.7kAutomated safety check: PassMIT
React Devdavila7/claude-code-templates32k2 repos~2.6kAutomated safety check: PassMIT
Typescript Rulesshinpr/claude-code-workflows690—~1.8kAutomated safety check: PassMIT

Similar skills

  • React Render Types Composition

    HorusGoul/eslint-plugin-react-render-types

    Composition patterns for building React components with @renders type annotations from eslint-plugin-react-render-types.

    111 GitHub stars~1.1k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • Safe Element Comparison

    seasonedcc/remix-forms

    Maintain element type comparison safety in remix-forms. An agent skill from seasonedcc/remix-forms.

    514 GitHub stars~1.8k tokensUpdated 5 mo ago
    Frontend & DesignAuto-check passed
  • Frontend Typescript Rules

    shinpr/ai-coding-project-boilerplate

    Applies React/TypeScript type safety, component design, and state management rules.

    232 GitHub stars~1.7k tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • React Dev

    davila7/claude-code-templates

    This skill should be used when building React components with TypeScript, typing hooks, handling events, or when React TypeScript, React 19, Server Components are mentioned.

    32k GitHub starsUsed in 2 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Typescript Rules

    shinpr/claude-code-workflows

    React/TypeScript frontend development rules including type safety, component design, state management, and error handling.

    690 GitHub stars~1.8k tokensUpdated 6 days ago
    Frontend & DesignAuto-check passed
  • React Code Review

    giuseppe-trisciuoglio/developer-kit

    Provides comprehensive code review capability for React applications, validates component architecture, hooks usage, React 19 patterns, state management, performance optimization, accessibility…

    355 GitHub stars~2.6k tokensUpdated 27 days ago
    Frontend & DesignAuto-check: notes

More from pproenca/dot-skills

All 182 skills in this repo
  • Audio Voice Recovery

    pproenca/dot-skills

    Audio forensics and voice recovery guidelines for CSI-level audio analysis.

    214 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Codemod React Pipeline

    pproenca/dot-skills

    Guided, scripted pipeline for running JSX/TSX/React codemods safely across large legacy codebases.

    214 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Dev Rfc

    pproenca/dot-skills

    Create well-structured RFCs and technical proposals for software projects.

    214 GitHub stars~3.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Dx Harness

    pproenca/dot-skills

    Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.

    214 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Language Spec Author

    pproenca/dot-skills

    Turn a rough idea for a language into a complete, implementable specification — a DSL, query, config/data, template, or protocol language — by interviewing the author dimension by dimension until…

    214 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Python Pep Author

    pproenca/dot-skills

    Drafting Python Enhancement Proposals (PEPs) — proposing a Python language feature, a standard library change, an interoperability standard, or an informational/process document for the Python…

    214 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Ast Grep Typescript React

What does Ast Grep Typescript React do?

A skill your agent uses when writing, debugging, or reviewing ast-grep patterns, YAML rules, or codemods against TypeScript or React (.ts/.tsx) code — searching for JSX elements, props, hooks…. Ast Grep Typescript React is an agent skill from pproenca/dot-skills.tsx) code — searching for JSX elements, props, hooks, imports, or type constructs, and rewriting them.

When should I use Ast Grep Typescript React?

Ast Grep Typescript React fits situations like: reviewing ast-grep patterns; codemods against TypeScript; React (.ts/.tsx) code — searching for JSX elements; type constructs.

How do I install Ast Grep Typescript React in Claude Code?

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

How do I install Ast Grep Typescript React in Codex?

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

Can I use Ast Grep Typescript React 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 pproenca/dot-skills --skill ast-grep-typescript-react -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-typescript-react, .gemini/skills/ast-grep-typescript-react, .github/skills/ast-grep-typescript-react and .opencode/skills/ast-grep-typescript-react in your project.

What does Ast Grep Typescript React need to run?

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

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

Ast Grep Typescript React is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ast Grep Typescript React use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 3.7k tokens, read only when the agent opens those files.

What are the alternatives to Ast Grep Typescript React?

Skills that share tags, products or a category with Ast Grep Typescript React: React Render Types Composition (HorusGoul/eslint-plugin-react-render-types, 111 stars), Safe Element Comparison (seasonedcc/remix-forms, 514 stars), Frontend Typescript Rules (shinpr/ai-coding-project-boilerplate, 232 stars) and React Dev (davila7/claude-code-templates, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ast Grep Typescript React?

pproenca (a GitHub user) maintains it in pproenca/dot-skills, which has 214 GitHub stars. The repository holds 182 skills in this directory. The repository was last updated on August 15, 2026.

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