CtrlK
BlogDocsLog inGet started
Tessl Logo

prp-codebase-question

Research codebase questions using parallel agents - documents what exists, not what should change. Use when the user asks how the codebase works, where something lives, or invokes /prp-codebase-question.

66

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is prp-codebase-question in Wirasm/prp

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 well-engineered workflow skill: phases are clearly sequenced with checkpoint validation, and the guidance (commands, agent prompts, templates) is fully executable. The main costs are redundancy from restated rules and reminders, and inline storage of a resolver script and long templates that would fit better as bundle files.

Suggestions

Remove the 'Critical Reminders' section (or collapse it into the phase instructions) — items 1-7 restate the 'Documentarian Only' rules and phase content already stated above.

Move the PRP store resolver bash block (marked 'keep byte-identical across skills') into a shared scripts/ file and invoke it by path, eliminating duplicated inline shell across skills.

Move the research document template and Phase 6 output template into a references/ file, keeping SKILL.md as a lean overview that links to them.

DimensionReasoningScore

Conciseness

The body is mostly efficient procedural instruction with no concept over-explanation, but 'Critical Reminders' restates the 'Documentarian Only' rules and phase checkpoints, and injunctions like 'No suggestions' appear in several forms across ~390 lines. This matches 'mostly efficient but could be tightened' rather than 'minor instances of over-explanation'.

3 / 5

Actionability

Fully executable guidance throughout: concrete bash commands (metadata gathering, the PRP store resolver, gh repo view), copy-paste agent prompt templates, an exact research-file path pattern, a complete document template, and a fill-in output format. Not below 5 since the common cases are covered with copy-paste-ready material.

5 / 5

Workflow Clarity

Six clearly sequenced phases each end in an explicit PHASE_#_CHECKPOINT checklist, with 'Wait for ALL agents before proceeding' and a 'No placeholder values remain' validation gate. This matches the anchor for clear sequence with explicit validation steps and checklists; the operation is non-destructive so no cap applies.

5 / 5

Progressive Disclosure

Well-sectioned single file with clear headers and no nested references, but the resolver block annotated 'keep byte-identical across skills' and the long document/output templates are inlined rather than split into a script or reference file. Good structure with minor organization gaps fits anchor 4 better than 3, since nothing is buried and navigation is easy.

4 / 5

Total

17

/

20

Passed

Description

78%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 that clearly answers both what the skill does and when to use it, with natural trigger phrases and a distinctive documentation-only positioning. Its only weakness is that the capability list is thin — the multi-agent research, synthesis, and evidence-document outputs are left implicit.

DimensionReasoningScore

Specificity

'Research codebase questions using parallel agents' and 'documents what exists' name the domain with two concrete actions, but omit capabilities like synthesizing findings into a research document and file:line evidence. This matches 'names domain and 1-2 concrete actions, not comprehensive' rather than 'several specific actions'.

3 / 5

Completeness

Both parts are explicit: what ('Research codebase questions using parallel agents - documents what exists, not what should change') and when, with concrete trigger phrases ('when the user asks how the codebase works, where something lives, or invokes /prp-codebase-question'). The 'when' is specific with triggers, exceeding anchor 4 whose 'when' could be more explicit.

5 / 5

Trigger Term Quality

'how the codebase works', 'where something lives', and the slash-command name are natural phrases users would say, but common variations like 'explain', 'trace', or 'architecture' are missing. Good coverage with a few natural terms absent fits anchor 4, not 5's synonym-and-extension comprehensiveness.

4 / 5

Distinctiveness Conflict Risk

The 'documents what exists, not what should change' carve-out clearly separates it from review/refactoring skills, but it could still overlap with general codebase-exploration or documentation skills. 'Mostly distinct; minor overlap risk' fits better than 5's 'minimal conflict risk'.

4 / 5

Total

16

/

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.