pull-request-guide

pull-request-guide is a skill for Claude Code from xonovex/platform. It costs 93 tokens per session (886 once invoked), scanned A, original, MIT.

A guide for authoring pull requests, which are proposed code changes submitted for review before being merged into a shared codebase.

In plain words
What is it for?
Use it to write or improve a pull-request description, split a large change, document testing, and prepare a change for reviewers.
Why use it?
It helps make the change understandable and reviewable by defining its scope, approach, testing evidence, trade-offs, and self-review steps.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the xonovex-skill-pull-request plugin — 1 skill shipped together

Good fit Use it to write or improve a pull-request description, split a large change, document testing, and prepare a change for reviewers.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/xonovex/platform/pull-request-guide
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add xonovex/platform --skill pull-request-guide
Clone the repo
git clone --depth 1 https://github.com/xonovex/platform

Made for: Claude Code.

Or install xonovex-skill-pull-request, the plugin that ships this one along with the rest of its 1 skill.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for pull-request-guide

README.md
[![agentmods](https://agentmods.dev/badge/skills/xonovex/platform/pull-request-guide.svg)](https://agentmods.dev/skills/xonovex/platform/pull-request-guide)
Your own site
<a href="https://agentmods.dev/skills/xonovex/platform/pull-request-guide"><img src="https://agentmods.dev/badge/skills/xonovex/platform/pull-request-guide.svg" alt="Measured on agentmods" height="20"></a>
Per session 93 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 886 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00093 $0.00886
Opus 5 $0.00046 $0.00443
Sonnet 5 $0.00019 $0.00177
Haiku 4.5 $0.00009 $0.00089

Measured today against content hash a3b51c6abf2f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

pull-request-guide scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

packages/skill/skill-pull-request/pull-request-guide/SKILL.md · 67 lines

How it starts

The opening of the file, as written. The whole thing — 67 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Pull Request Authoring Guidelines

How to write a pull request that gets reviewed fast and correctly. This skill owns the author's craft and returns the title and description inline during Create. Host creation, updates, and work-item links require a separate Publish operation with the git host's tooling; reviewer feedback lives in code-review-guide, and branch or commit work lives in git-guide.

Essentials

Gotchas

  • "Tested locally" tells the reviewer nothing - name the scenario, the environment, and how they can re-run it
  • Line count measures volume, not risk - a 20-line auth change needs more scrutiny than a 400-line generated-code or scaffolding diff, so call those out
  • A refactor bundled into a feature PR hides the real change - split it into its own PR
  • A PR merges only on the required approving review(s) plus green required status checks (branch protection) - never bypass the gate
  • Drafting a PR is not authorization to create or update one on a host

Example

A filled description for a small, focused change:

## What

Cache the resolved feature-flag set per request instead of re-reading it on every check.

## Why

PROJ-1234: the flag store was hit ~40x per request, adding ~15ms p95. Memoize it for the request scope.

## Changes

- Add a request-scoped FlagCache, resolve once in the entry middleware.
- Replace direct store reads in isEnabled() with the cache.

## Testing

- Unit: new FlagCache hit/miss/expiry tests.
- Manual: ran the planner flow locally, p95 dropped 210ms -> 195ms (logs attached).

## Tradeoffs / risks

- Flags changed mid-request are not picked up until the next request. Acceptable, flags do not change within a request.

## Related PRs

Part of the flag-perf set: !123, !124.

Read the full file on GitHub · 67 lines

Files

What ships with it

9 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today First seen · 67 lines · 93 tokens per session scan A a3b51c6abf2f

Subscribe to this mod's changes

pull-request-guide is a skill published in the GitHub repository xonovex/platform (5 stars, last pushed yesterday), licensed MIT. It adds 93 tokens to every session and 886 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-08.