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.

78

Quality

98%

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.

The body is an exemplary instruction-only skill: lean directive prose, an explicit decision tree with fallbacks, sequenced stages with validation and verification checkpoints, and no superfluous content that should live in separate files. Nothing material is missing at this scope.

DimensionReasoningScore

Conciseness

The ~55-line body assumes Claude's competence throughout: every sentence is a behavioral directive ('Do not publish a UNRESOLVED diagnosis as fact', 'Do not create a separate local RCA document. The GitHub issue or comment is the artifact.') with zero concept explanation or padding. This matches the 5 anchor (lean, every token earns its place); there is nothing to trim to reach 4 or below.

5 / 5

Actionability

Although it is an instruction-only skill with no code (not penalized per the scoring notes), the guidance is fully executable: an explicit decision tree ('One clear match → use it', 'Several plausible matches → ask the user', 'No clear match → plan to create an issue'), an enumerated list of required RCA outputs, per-case publication behavior, and a concrete verification step ('Read the created or updated issue back to verify the content'). It matches the 5 anchor's copy-paste-ready specificity for an orchestration skill; 4 would require minor gaps, and none are evident.

5 / 5

Workflow Clarity

The four numbered stages (resolve target → run root-cause analysis → reconcile duplicates → publish) are clearly sequenced with explicit validation checkpoints: UNRESOLVED/CCONDITIONAL gating before publication, re-checking duplicate candidates against the diagnosed cause, stopping before publication when GitHub access is missing, and a read-back verification of the published artifact. This matches the 5 anchor (explicit validation, feedback loops); the 4 anchor would require missing checkpoints, and none are.

5 / 5

Progressive Disclosure

The skill is a self-contained workflow with no bundle files and no content that belongs in separate references; per the simple-skill scoring note, well-organized sections suffice. Sections are cleanly numbered with descriptive headings and easy in-file navigation, matching the 5 anchor's easy-navigation standard rather than the 4 anchor's 'minor organization gaps'.

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 multi-action capability statement, explicit and quoted trigger phrases, and clear default behavior, all in third person. The only residual risk is overlap with generic debugging skills via the broad 'debug this' trigger.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Diagnoses a bug, error, stack trace, regression, or unexplained behavior', 'publishes the evidence-backed root cause to GitHub', 'commenting on the matching open issue or creating one when none exists' — with comprehensive coverage of the skill's diagnostic and publication behavior in third-person voice. It clearly matches the 5 anchor (multiple specific concrete actions, comprehensive) rather than 4, which requires minor gaps in coverage.

5 / 5

Completeness

It explicitly answers 'what' (diagnose and publish the evidence-backed root cause, with the default publication behavior stated) and 'when' ('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'). Both halves are explicit with concrete trigger phrases, matching the 5 anchor exactly.

5 / 5

Trigger Term Quality

It quotes natural user phrases ('debug this', 'find the root cause', 'investigate a GitHub issue') and covers synonyms across the domain — bug, error, stack trace, regression, unexplained behavior, bug report — plus the explicit invocation name $prp-debug. Comprehensive natural-term coverage fits the 5 anchor; nothing common is missing.

5 / 5

Distinctiveness Conflict Risk

The niche is distinct — root-cause diagnosis with durable GitHub publication, explicitly scoped away from implementing the fix — but the trigger 'debug this' is a very common phrase that could also fire for general debugging/verify skills, so it sits between the 4 anchor (mostly distinct, minor overlap risk with closely related skills) and the 5 anchor (minimal conflict risk). It is above the midpoint because the publication focus and $prp-debug invocation clearly carve the niche.

4 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.