CtrlK
BlogDocsLog inGet started
Tessl Logo

prp-debug

Diagnoses a bug, error, stack trace, regression, or unexplained behavior and publishes the evidence-backed root cause to GitHub. Use when the user says "debug this", "find the root cause", provides a bug report or stack trace, asks to investigate a GitHub issue, or invokes /prp-debug. Defaults to commenting on the matching open issue or creating one when none exists.

77

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A lean, fully actionable instruction-only skill: an unambiguous four-phase workflow with explicit validation checkpoints, concrete decision branches for every common case, and clean section organization requiring no bundle files. No dimension shows a meaningful gap between the written guidance and what is needed to execute the skill.

DimensionReasoningScore

Conciseness

The ~430-word body is pure directive content — "Spawn prp-core:root-cause-analyzer with the original report", "Do not publish a UNRESOLVED diagnosis as fact", "Read the created or updated issue back to verify the content" — with zero explanations of concepts Claude already knows and no padding. Every token earns its place, matching the level-5 anchor; level 4 would require identifiable trimmable over-explanation, which is absent.

5 / 5

Actionability

As an instruction-only skill it provides concrete, executable guidance throughout: explicit decision branches ("One clear match → use it", "Several plausible matches → ask the user", "No clear match → plan to create an issue"), a enumerated requirement list for the analysis, and an exact specification of the comment contents ("corrected problem statement, reproduction evidence, root cause or explicit condition, causal chain, fix boundary, regression proof, and remaining uncertainty"). It is not level 4 because all common cases (existing issue, no issue, duplicate, no GitHub access, --no-publish, --rewrite-body, UNRESOLVED, CONDITIONAL) are explicitly covered with concrete handling.

5 / 5

Workflow Clarity

Four clearly sequenced phases (resolve target → run analysis → reconcile duplicates → publish) with explicit validation checkpoints: a required regression check that "fails before the fix and passes after it", a post-diagnosis duplicate re-check, a stop-before-publication guard when GitHub access fails, and a read-back verification of the published artifact. Not level 4: checkpoints are explicit and complete, including error-recovery paths (UNRESOLVED handling, disabled publication treated as non-failure).

5 / 5

Progressive Disclosure

The body is under 50 lines, needs no external reference files (verified: no references/, scripts/, or assets/ exist in the bundle), and is organized into four well-labeled numbered sections with the delegation to prp-core:root-cause-analyzer clearly signaled. Per the simple-skill guideline, this earns the level-5 anchor; nothing that belongs in a separate file is inlined.

5 / 5

Total

20

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete third-person capabilities, an explicit 'Use when' clause with natural trigger phrases and synonyms, and a distinct diagnosis-plus-publication niche. The only weakness is that broadly-worded debugging triggers ('debug this') could collide with a general debugging skill.

DimensionReasoningScore

Specificity

"Diagnoses a bug, error, stack trace, regression, or unexplained behavior and publishes the evidence-backed root cause to GitHub" plus "commenting on the matching open issue or creating one when none exists" lists multiple concrete actions (diagnose, publish, comment, create) with comprehensive coverage of the skill's scope, in third-person voice. It clearly matches the level-5 anchor and exceeds level 4 because coverage is comprehensive rather than having minor gaps.

5 / 5

Completeness

It explicitly answers "what" (diagnose and publish an evidence-backed root cause to GitHub) and "when" ("Use when the user says 'debug this', 'find the root cause', provides a bug report or stack trace...") with concrete trigger phrases, matching the level-5 anchor exactly. It is not level 4 because the 'when' clause is fully explicit rather than improvable.

5 / 5

Trigger Term Quality

Natural trigger phrases include "debug this", "find the root cause", "provides a bug report or stack trace", "asks to investigate a GitHub issue", and "invokes /prp-debug", covering synonyms (bug, error, stack trace, regression, unexplained behavior) plus the literal slash-command name. This is comprehensive natural-term coverage, not the level-4 anchor where natural terms are missing.

5 / 5

Distinctiveness Conflict Risk

The niche is mostly distinct — evidence-backed root-cause analysis with durable GitHub publication — but the trigger "debug this" is broad enough to overlap with a general-purpose debugging skill, so minor overlap risk with a closely related skill remains. It is above level 3 (the domain and artifact are specific) but below level 5 because generic debugging phrases are not fully scoped to this skill's publish-the-finding behavior.

4 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
Wirasm/prp
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.