Official agent skill

Astro PR Writer

by withastro in withastro/astro

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

OfficialCustom licenceAuto-check passedDevelopment

Install Astro PR Writer

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

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

GitHub CLI
$ gh skill install withastro/astro astro-pr-writer --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-pr-writer .claude/skills/astro-pr-writer && 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-pr-writer
GitHub stars
63k
Token cost
~1.2k tokens
SKILL.md length
633 words
Files
2
Skills in repo
10
Repo updated
First seen
Licence
Custom licence

At a glance

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

  • Ever the user asks to create a PR
  • SKILL.md covers Core Principle, PR Title Rules, Body Rules and Brevity Guidance, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Update PR title/body

What it does

Astro PR Writer is an agent skill from withastro/astro, published by the product's own GitHub organization. Write and update Astro pull requests with reviewer-friendly titles and high-signal bodies. Trigger whenever the user asks to create a PR, open a PR, draft a PR, update PR title/body, or write PR notes/summary/description.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `evals/evals.json`).

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

When your agent uses it

  • Ever the user asks to create a PR
  • Update PR title/body
  • Write PR notes/summary/description

Example prompts

  • “/astro-pr-writer”

What it can do on your machine

Read from SKILL.md and the folder at commit 9050e38. 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 markdown).

    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

Astro PR Writer loads about 1.2k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 633 words of instructions outside code blocks.

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

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

“Write Astro pull request descriptions that help reviewers quickly understand intent, behavior changes, and validation.”

— opening of SKILL.md by withastro, Custom licence
name
astro-pr-writer

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/astro-pr-writer of withastro/astro.

  • SKILL.md
  • evals/evals.json

Open the folder on GitHubat commit 9050e38

Compare with similar skills

Astro PR Writer 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 PR Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Astro PR Writer this skillwithastro/astro63k—~1.2kAutomated safety check: PassCustom licence
Docs AuthoringTracecatHQ/tracecat3.8k—~3.1kAutomated safety check: NotesAGPL-3.0
Create PRUniClipboard/UniClipboard1.9k—~4.6kAutomated safety check: PassAGPL-3.0
Work Issuejoesaby/astro-mermaid123—~891Automated safety check: PassMIT
CodFlow Change Workflowbighadj22/codflow354—~1.1kAutomated safety check: PassApache-2.0
Adapter Alignmentevloghq/evlog1.9k—~1.3kAutomated safety check: PassMIT

Similar skills

  • Docs Authoring

    TracecatHQ/tracecat

    A skill your agent uses when adding or updating documentation pages in an existing docs site.

    3.8k GitHub stars~3.1k tokensUpdated today
    DevelopmentAuto-check: notes
  • Create PR

    UniClipboard/UniClipboard

    Push the current branch and open a GitHub pull request against main.

    1.9k GitHub stars~4.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Work Issue

    joesaby/astro-mermaid

    End-to-end workflow for resolving a GitHub issue in astro-mermaid — triages complexity, then runs brainstorm → TDD → implement → docs/spec → code review at the right depth.

    123 GitHub stars~891 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • CodFlow Change Workflow

    bighadj22/codflow

    A step-by-step workflow for changing the CodFlow repository: read the AGENTS.md contract, respect package boundaries, verify before claiming done and keep PRs small.

    354 GitHub stars~1.1k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Adapter Alignment

    evloghq/evlog

    Twice-monthly check that evlog's drain adapters still send what each provider's own client sends.

    1.9k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Repo Health Sweep

    evloghq/evlog

    Twice-weekly, coverage-led simplification audit over the whole evlog repository and Evi's real communication.

    1.9k GitHub stars~3.9k 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
  • 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
  • Astro Code Review

    withastro/astro

    Official

    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.

    63k GitHub stars~7.6k 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

Questions about Astro PR Writer

What does Astro PR Writer do?

Write and update Astro pull requests with reviewer-friendly titles and high-signal bodies. Astro PR Writer is an agent skill from withastro/astro, published by the product's own GitHub organization. Write and update Astro pull requests with reviewer-friendly titles and high-signal bodies.

When should I use Astro PR Writer?

Astro PR Writer fits situations like: ever the user asks to create a PR; update PR title/body; write PR notes/summary/description.

How do I install Astro PR Writer in Claude Code?

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

How do I install Astro PR Writer in Codex?

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

Can I use Astro PR Writer 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-pr-writer -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-pr-writer, .gemini/skills/astro-pr-writer, .github/skills/astro-pr-writer and .opencode/skills/astro-pr-writer in your project.

What does Astro PR Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Astro PR Writer is instructions for the agent only.

Does Astro PR Writer 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 Astro PR Writer 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 PR Writer use?

Astro PR Writer 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 PR Writer use?

About 1.2k tokens (SKILL.md is roughly 5k 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 PR Writer?

Skills that share tags, products or a category with Astro PR Writer: Docs Authoring (TracecatHQ/tracecat, 3.8k stars), Create PR (UniClipboard/UniClipboard, 1.9k stars), Work Issue (joesaby/astro-mermaid, 123 stars) and CodFlow Change Workflow (bighadj22/codflow, 354 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Astro PR Writer?

withastro (a GitHub organization, an official publisher) maintains it in withastro/astro, which has 63,145 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 10, 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.