prp: Skill for Claude Code

.agents/skills/prp-debug/SKILL.md

prp-debug is a skill for Claude Code from Wirasm/prp. It costs 84 tokens per session (852 once invoked), scanned A, original, MIT.

A workflow for finding the root cause of a software bug and recording the evidence in the appropriate GitHub issue. Root cause means the underlying reason the problem occurs, not just its visible symptom.

In plain words
What is it for?
Use it to investigate bugs, stack traces, unexpected behavior, or GitHub issues. It gathers context, checks related discussions, and publishes the diagnosis without changing the code.
Why use it?
It separates investigation from implementation, helping turn a vague report, error, or regression into a documented and reproducible diagnosis.

Skill for Claude Code

Written for Claude Code: $ARGUMENTS substitution. Also seen: positional $N argument; installed under .agents/ (shared by several agents); $skill-name invocation.

This is Wirasm/prp's own configuration. It tells Claude Code how to work on prp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything prp configures →

View source ↗ Wirasm/prp
About the project

PRP is a collection of prompts and workflows for AI-assisted software development with Claude Code. Its Product Requirement Prompts combine product requirements, selected codebase context, and an execution runbook so a coding agent can implement a vertical slice of software. The catalogue entries are the project’s own skills, agents, instructions, hook, and plugin workflows.

Wirasm/prp · 2,264 stars · on GitHub

Reuse

Borrowing it

Nothing to install: this file belongs to Wirasm/prp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/Wirasm/prp/development/.agents/skills/prp-debug/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/Wirasm/prp

Made for: Claude Code.

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 prp-debug

README.md
[![agentmods](https://agentmods.dev/badge/skills/wirasm/prp/prp-debug/github.svg)](https://agentmods.dev/skills/wirasm/prp/prp-debug)
Your own site
<a href="https://agentmods.dev/skills/wirasm/prp/prp-debug"><img src="https://agentmods.dev/badge/skills/wirasm/prp/prp-debug/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 prp-debug

Your own site · 80×15
<a href="https://agentmods.dev/skills/wirasm/prp/prp-debug"><img src="https://agentmods.dev/badge/skills/wirasm/prp/prp-debug.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 84 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 852 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. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
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.00084 $0.00852
Opus 5.5 $0.00034 $0.00341
Sonnet 5.5 $0.00017 $0.00170
Haiku 4.5 $0.00008 $0.00085

Measured 1mo ago against content hash 96f041bc8ab2, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

prp-debug 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 1mo 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.

.agents/skills/prp-debug/SKILL.md · 61 lines

How it starts

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

Arguments: $ARGUMENTS (and $1, $2, ...) refer to the arguments given when this skill was invoked. Take them from the user's request; if absent, infer them from the conversation.

PRP Debug

Diagnose broken current behavior through the root-cause-analyzer, then make the finding durable in the appropriate GitHub issue. Do not implement the fix.

Input: $ARGUMENTS (if absent, use the conversation).

1. Resolve the report and publication target

Read repository guidance and establish the complete report: symptom, expected behavior, environment, reproduction, logs, and any supplied stack trace.

When the input points to a GitHub issue, read its body, relevant comments, linked issues, duplicates, pull requests, and attachments before diagnosing. Treat the body as historical context, not verified causality.

When no issue is specified, search open issues in the current GitHub repository using the symptom, distinctive errors, affected feature, and likely underlying behavior. Inspect candidate bodies and discussion; title similarity alone is not a duplicate.

  • One clear match → use it.
  • Several plausible matches → ask the user which issue should own the finding.
  • No clear match → plan to create an issue after diagnosis.

If GitHub access or the repository cannot be resolved, complete the diagnosis but stop before publication and state what access is missing. Honor --no-publish or an equivalent explicit request without treating publication as a failure.

2. Run the root-cause analysis

Spawn root-cause-analyzer with the original report, complete tracker context, repository path, and any decisive runtime evidence already available. Do not give it a preferred cause or fix.

Require:

  • reproduction at the cheapest authoritative boundary when reasonably possible;
  • competing hypotheses and focused falsification;
  • a causal chain from observed symptom to the smallest fixable cause;
  • the violated invariant and its smallest responsible fix boundary: the existing or missing primitive that should own it, not merely the smallest patch;
  • rejected alternatives and explicit uncertainty;
  • a regression check that fails before the fix and passes after it.

Read the full file on GitHub · 61 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. 1mo ago First seen · 61 lines · 84 tokens per session scan A 96f041bc8ab2

Subscribe to this mod's changes

prp-debug is a skill published in the GitHub repository Wirasm/prp (2,264 stars, last pushed 18d ago), licensed MIT. It adds 84 tokens to every session and 852 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-08-30.

Related

Other skills, from other repositories

git-advanced-workflows

Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use when managing complex Git histories, collaborating on feature branches, or troubleshooting repository issues.

wshobson/agents · 54 tokens

agent-merge-conflict-arbiter

Neutral arbiter for merge conflicts between two agents.

NousResearch/hermes-agent · 19 tokens

enable-check-includes-strict

Enable and migrate Chromium targets and directories to checkincludesstrict = true, diagnosing and resolving header include violations as part of the checkincludesstrict LSC. Use when adding directories to the allowlist, enabling strict header checks on targets, or resolving CHECKINCLUDESSTRICTUNTRIAGED targets.

chromium/chromium · 70 tokens

resolve-handoff

Emit the complete Resolve handoff with exact modes, outcomes, test evidence, and publication state.

omnigent-ai/omnigent · 23 tokens

reproduce-and-fix-issues

Reproduce triaged Slack bugs through a configured app-control adapter, verify existing fixes, and open a bounded draft pull request only after before-and-after proof. Use only from the configured Benny repro automation.

backnotprop/pstack · 48 tokens

cy-orquestrate-issue

Orchestrate GitHub bug resolution through a new CompozyOS managed worktree and Codex Astra High session per issue. Investigate reported bugs, create missing issues, and dispatch a Goal-backed executor responsible for a detailed PR, green CI, and all CodeRabbit and Greptile feedback. Use when asked to delegate issue…

compozy/compozy · 92 tokens