pr-quality-roadmap

pr-quality-roadmap is a skill for Claude Code from rjmurillo/ai-agents. It costs 86 tokens per session (1,462 once invoked), scanned A, original, MIT.

A product-focused review of your local code changes. It checks whether the work matches the roadmap, avoids unnecessary scope, and provides real user value.

In plain words
What is it for?
Review a Git diff for strategic fit, scope creep, and user value, returning PASS, WARN, or CRITICAL FAIL.
Why use it?
It can expose work that has drifted from the planned goal or grown beyond what users need before the change is merged.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Part of the project-toolkit plugin — 125 skills, 25 commands, 33 agents, 5 hooks shipped together

Good fit Review a Git diff for strategic fit, scope creep, and user value, returning PASS, WARN, or CRITICAL FAIL.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/rjmurillo/ai-agents/pr-quality-roadmap
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 rjmurillo/ai-agents --skill pr-quality-roadmap
Clone the repo
git clone --depth 1 https://github.com/rjmurillo/ai-agents

Made for: Claude Code.

Or install project-toolkit, the plugin that ships this one along with the rest of its 125 skills, 25 commands, 33 agents, 5 hooks.

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 pr-quality-roadmap

README.md
[![agentmods](https://agentmods.dev/badge/skills/rjmurillo/ai-agents/pr-quality-roadmap/github.svg)](https://agentmods.dev/skills/rjmurillo/ai-agents/pr-quality-roadmap)
Your own site
<a href="https://agentmods.dev/skills/rjmurillo/ai-agents/pr-quality-roadmap"><img src="https://agentmods.dev/badge/skills/rjmurillo/ai-agents/pr-quality-roadmap/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for pr-quality-roadmap

Your own site · 80×15
<a href="https://agentmods.dev/skills/rjmurillo/ai-agents/pr-quality-roadmap"><img src="https://agentmods.dev/badge/skills/rjmurillo/ai-agents/pr-quality-roadmap.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 86 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,462 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.00086 $0.01462
Opus 5.5 $0.00034 $0.00585
Sonnet 5.5 $0.00017 $0.00292
Haiku 4.5 $0.00009 $0.00146

Measured 18d ago against content hash 6eb81848540d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

pr-quality-roadmap 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 18d ago.

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.

.claude/skills/pr-quality-roadmap/SKILL.md · 122 lines

How it starts

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

PR Quality Gate: Roadmap

Run the roadmap axis of the quality gate against your working changes, before you push, using the canonical axis criteria.

Migrated from the pr-quality/roadmap command under ADR-064, which makes skills the single user-invocable surface and renames the namespaced sub-command pr-quality/roadmap to pr-quality-roadmap. The command file is gone, so its path is named here in plain text rather than as a citation to something a reader could open.

Triggers

roadmap review my changes, run the roadmap gate, does this serve a real user, pr-quality roadmap

Arguments

Base branch: $ARGUMENTS

If $ARGUMENTS names a branch, diff against it. Otherwise default to main.

Criteria

Apply the criteria from: @.github/prompts/pr-quality-gate-roadmap.md

That file is the canonical axis definition and the one definition this skill reads. Do not paraphrase it from memory: read it, then judge the diff against what it says.

Process

  1. Run git branch --show-current to name the current branch.
  2. Resolve the base branch from $ARGUMENTS, defaulting to main. Reject an empty value or one starting with - (Git parses a leading dash as an option, not a ref), then resolve it to a commit with BASE_SHA=$(git rev-parse --verify --quiet "<base_branch>^{commit}"). An unresolved or rejected ref is a hard stop: report it and do not fall back to an empty diff. Use $BASE_SHA in every git command below, not the branch name: the branch can move between this step and a later diff, and the SHA cannot.
  3. Build the changed-file list from tracked changes (git diff "$BASE_SHA" --name-only) plus untracked files (git ls-files --others --exclude-standard); the local review scope is uncommitted changes, and a tracked-only diff misses a change set that is entirely new files. Read each untracked file's full content directly, since it carries no diff against the base.
  4. Run git diff "$BASE_SHA" to read the full diff of tracked changes.
  5. Judge the diff against every criterion in the axis file. Findings are additive: a criterion that fails does not end the pass, because the author needs the whole list in one round rather than one finding per round.
  6. Emit the verdict block, then the JSON block.

Read the full file on GitHub · 122 lines

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. 18d ago Changed 6eb81848540d
  2. 22d ago Changed · +6 lines 21485eb1a429
  3. 1mo ago Changed · +14 lines 43b6a3792dba
  4. 1mo ago First seen · 102 lines · 86 tokens per session scan A 0dc54eeea6b7

Subscribe to this mod's changes

pr-quality-roadmap is a skill published in the GitHub repository rjmurillo/ai-agents (48 stars, last pushed today), licensed MIT. It adds 86 tokens to every session and 1,462 once invoked, about $0.0003 per session on Opus 5.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.