Official agent skill

Astro Code Review

by withastro in withastro/astro

Perform a static, read-only code review of an Astro pull request or of a local branch, commit range, diff, patch, or working tree being prepared as a pull request.

OfficialCustom licenceAuto-check passedDevelopment

Install Astro Code Review

skills CLI
$ npx skills add withastro/astro --skill astro-code-review -a claude-code

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

GitHub CLI
$ gh skill install withastro/astro astro-code-review --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/withastro/astro.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/astro-code-review .claude/skills/astro-code-review && 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
astro-code-review
GitHub stars
63k
Token cost
~7.6k tokens
SKILL.md length
3,778 words
Files
2
Skills in repo
10
Repo updated
First seen
Licence
Custom licence

At a glance

Perform a static, read-only code review of an Astro pull request or of a local branch, commit range, diff, patch, or working tree being prepared as a pull request.

  • Works in 4 steps: Run the permitted fetch once. → Find the merge base of HEAD and… → Inspect the diff from that merge base to… → …
  • Tasks that involve Static sites and blogs
  • SKILL.md covers Safety Boundary, Establish the Review Scope, Gather Context and Merge Requirements, plus 4 more sections
  • Calls git and gh

What it does

Astro Code Review is an agent skill from withastro/astro, published by the product's own GitHub organization. Perform a static, read-only code review of an Astro pull request or of a local branch, commit range, diff, patch, or working tree being prepared as a pull request. Determine whether the change satisfies its stated business requirements and is good enough to merge, using the PR description, linked requirement issues and roadmap items, and PR or issue discussions when available. Use this skill only for PR review or self-review, not issue triage or bug investigation. It reports only merge-relevant findings and never…

Its SKILL.md is about 7.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `evals/evals.json`). Compatibility notes: Uses read-only GitHub tools, gh, and git when available; can review a supplied diff and provided PR context without them.

It sits in Development, covering Static sites and blogs, Pull requests and Code review. It works with Astro and Git. The repository describes itself as: The web framework for content-driven websites.

When your agent uses it

  • Tasks that involve Static sites and blogs
  • Tasks that involve Pull requests
  • Tasks that involve Code review

Example prompts

  • “/astro-code-review”

Requirements

  • Compatibility (from SKILL.md): Uses read-only GitHub tools, `gh`, and `git` when available; can review a supplied diff and provided PR context without them.

Workflow steps

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

  1. Run the permitted fetch once.
  2. Find the merge base of HEAD and origin/main.
  3. Inspect the diff from that merge base to the working tree. This includes committed, staged, and unstaged changes to tracked files.
  4. Use Git status to identify untracked files, then read those files directly.

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • git
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.astro.build
    • developer.mozilla.org

    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.

  • Compatibility

    Uses read-only GitHub tools, `gh`, and `git` when available; can review a supplied diff and provided PR context without them.

    From compatibility in the SKILL.md frontmatter.

Context cost

Astro Code Review loads about 7.6k tokens when it runs. Until then it costs about 151 tokens; SKILL.md has 3,778 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~151
When it runs · the whole SKILL.md, loaded when a task matches
~7.6k

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 3,778 words (~7,633 tokens).

“Determine whether the available evidence supports merging a proposed change. A merge-ready change satisfies its stated business requirements and Astro's required correctness, security, compatibility, and repository policies; it does not need to be perfect. Report only issues that should be…”

— opening of SKILL.md by withastro, Custom licence
name
astro-code-review
compatibility
Uses read-only GitHub tools, `gh`, and `git` when available; can review a supplied diff and provided PR context without them.

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/astro-code-review of withastro/astro.

  • SKILL.md
  • evals/evals.json

Open the folder on GitHubat commit 28e7410

Compare with similar skills

Astro Code Review 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.

Astro Code Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Astro Code Review this skillwithastro/astro63k—~7.6kAutomated safety check: PassCustom licence
Understand Diff AnalysisEgonex-AI/Understand-Anything86k1 repos~1.4kAutomated safety check: PassMIT
Open Code Review CLIalibaba/open-code-review44k—~3.1kAutomated safety check: PassApache-2.0
Code Reviewflutter/flutter179k—~1.4kAutomated safety check: PassBSD-3-Clause
PR Review State Fetchprisma/orm48k—~767Automated safety check: PassApache-2.0
Knowledge Graph PR Reviewtirth8205/code-review-graph32k—~452Automated safety check: PassMIT

Similar skills

  • Understand Diff Analysis

    Egonex-AI/Understand-Anything

    Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.

    86k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • Open Code Review CLI

    alibaba/open-code-review

    Runs the ocr command-line tool to review Git changes, a commit or a branch comparison with an AI model, returning line-level comments and optionally applying fixes.

    44k GitHub stars~3.1k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Code Review

    flutter/flutter

    Performs a comprehensive, multi-step code review of pull requests or local code changes, using iterative refinement (generation, critique, synthesis) to ensure high-quality, actionable feedback.

    179k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Official

    Fetches a pull request's canonical review state as JSON, validates it, and renders markdown, a text summary and triage target files from it using bundled scripts.

    48k GitHub stars~767 tokensUpdated today
    DevelopmentAuto-check passed
  • Knowledge Graph PR Review

    tirth8205/code-review-graph

    Reviews a pull request or branch diff with a code knowledge graph and produces a structured review that includes blast-radius analysis.

    32k GitHub stars~452 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Official

    Runs the triage step of the review-framework loop: reads fetched PR review state, builds `review-actions.json`, validates it and renders `review-actions.md`.

    48k GitHub stars~995 tokensUpdated today
    DevelopmentAuto-check passed

More from withastro/astro

All 10 skills in this repo
  • Official

    Analyze recent GitHub Actions workflow runs to identify patterns, mistakes, and improvements.

    63k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Astro Developer

    withastro/astro

    Official

    Comprehensive guide for developing in the Astro monorepo. An agent skill from withastro/astro.

    63k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Astro PR Writer

    withastro/astro

    Official

    Write and update Astro pull requests with reviewer-friendly titles and high-signal bodies.

    63k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Changeset

    withastro/astro

    Official

    Create a changeset for the Astro monorepo. An agent skill from withastro/astro.

    63k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Writing Comments

    withastro/astro

    Official

    How to write JSDoc (/ /) and inline (//) comments in the Astro codebase, for contributors reading the source — not end users.

    63k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Official

    Takes a bug report for the triagebot-action GitHub Action through reproduction, root-cause diagnosis, an intended-behavior check and a fix attempt.

    63k GitHub stars~639 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Astro Code Review

What does Astro Code Review do?

Perform a static, read-only code review of an Astro pull request or of a local branch, commit range, diff, patch, or working tree being prepared as a pull request. Astro Code Review is an agent skill from withastro/astro, published by the product's own GitHub organization. Perform a static, read-only code review of an Astro pull request or of a local branch, commit range, diff, patch, or working tree being prepared as a pull request.

When should I use Astro Code Review?

Astro Code Review fits situations like: tasks that involve Static sites and blogs; tasks that involve Pull requests; tasks that involve Code review.

How do I install Astro Code Review in Claude Code?

Run `npx skills add withastro/astro --skill astro-code-review -a claude-code`. Or copy the skill folder (.agents/skills/astro-code-review in withastro/astro) into .claude/skills/astro-code-review in your project. Claude Code loads it when a task matches its description.

How do I install Astro Code Review in Codex?

Run `npx skills add withastro/astro --skill astro-code-review -a codex`. Or copy the skill folder (.agents/skills/astro-code-review in withastro/astro) into .agents/skills/astro-code-review in your project. Codex loads it when a task matches its description.

Can I use Astro Code Review 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 withastro/astro --skill astro-code-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/astro-code-review, .gemini/skills/astro-code-review, .github/skills/astro-code-review and .opencode/skills/astro-code-review in your project.

What does Astro Code Review need to run?

Going by SKILL.md and its folder, Astro Code Review needs the command-line tools its instructions call (git and gh). Compatibility (from SKILL.md): Uses read-only GitHub tools, `gh`, and `git` when available; can review a supplied diff and provided PR context without them..

Does Astro Code Review access the network?

SKILL.md names 2 domains. As links in the text: docs.astro.build and developer.mozilla.org. This is read from the text; nothing was executed.

Is Astro Code Review 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 Astro Code Review use?

Astro Code Review 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 Astro Code Review use?

About 7.6k tokens (SKILL.md is roughly 31k 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 Astro Code Review?

Skills that share tags, products or a category with Astro Code Review: Understand Diff Analysis (Egonex-AI/Understand-Anything, 86k stars), Open Code Review CLI (alibaba/open-code-review, 44k stars), Code Review (flutter/flutter, 179k stars) and PR Review State Fetch (prisma/orm, 48k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Astro Code Review?

withastro (a GitHub organization, an official publisher) maintains it in withastro/astro, which has 63,106 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 8, 2026.

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