CtrlK
BlogDocsLog inGet started
Tessl Logo

prd

Use when a PM has a rough idea or a written PRD that needs to be structured into the standard format with P0/P1/P2-tagged user stories. Auto-discovers the source doc in the project folder. Use --approved to skip the challenge step.

84

1.85x
Quality

76%

Does it follow best practices?

Impact

100%

1.85x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/prd/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

75%

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

This is a solid description that clearly communicates when to use the skill and what it does at a high level. Its main weakness is that it could be more specific about the concrete actions performed and include more natural trigger term variations (e.g., 'product requirements document,' 'spec,' 'requirements'). The explicit 'Use when...' clause and distinctive domain focus are strong points.

Suggestions

Add more natural trigger term variations such as 'product requirements document,' 'spec,' 'product spec,' 'requirements,' or 'prioritize features' to improve discoverability.

List more specific concrete actions the skill performs, e.g., 'parses rough ideas into structured sections, generates prioritized user stories with acceptance criteria, organizes requirements by P0/P1/P2 priority.'

DimensionReasoningScore

Specificity

The description mentions structuring into a 'standard format with P0/P1/P2-tagged user stories' and 'auto-discovers the source doc,' which are somewhat specific actions, but it doesn't comprehensively list all concrete actions the skill performs (e.g., what does 'challenge step' entail, what does structuring involve beyond tagging).

2 / 3

Completeness

The description explicitly answers both 'what' (structures a rough idea or PRD into standard format with prioritized user stories) and 'when' ('Use when a PM has a rough idea or a written PRD that needs to be structured'). The 'Use when...' clause is present and clear.

3 / 3

Trigger Term Quality

Includes relevant terms like 'PRD,' 'user stories,' 'P0/P1/P2,' and 'PM,' which are natural keywords a product manager might use. However, it misses common variations like 'product requirements document,' 'requirements,' 'spec,' 'product spec,' or 'prioritization.'

2 / 3

Distinctiveness Conflict Risk

The description carves out a clear niche: PRD structuring with P0/P1/P2 user story tagging for PMs. The specific mention of priority tagging, the challenge step, and the --approved flag make it highly distinctive and unlikely to conflict with other skills.

3 / 3

Total

10

/

12

Passed

Implementation

77%

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

This is a well-structured, highly actionable skill with clear multi-step workflow and good branching logic for different scenarios. Its main strengths are precise instructions for priority tagging, file output format, and conditional flow control. Minor weaknesses include a reference to `template.md` that isn't provided in the bundle and some sections that could be slightly more concise.

Suggestions

Provide the referenced `template.md` as a bundle file, or inline the template structure directly in the skill so Claude knows the exact output format.

Consider tightening the full interview questions in Step 2 — they could be presented as a compact list rather than individually numbered verbose prompts.

DimensionReasoningScore

Conciseness

The skill is mostly efficient and avoids explaining concepts Claude already knows, but some sections could be tightened — e.g., the full interview questions in Step 2 are somewhat verbose, and the challenge checklist in Step 4 could be more compact. The table format in Step 2 is a nice touch for density though.

2 / 3

Actionability

Highly actionable throughout: concrete file paths, exact CLI arguments, specific priority-tagging rules ('must/required/critical' → P0), stable ID format (US-XX), exact YAML frontmatter to write, specific approval language patterns to detect, and clear next-step prompts. Every step tells Claude exactly what to do.

3 / 3

Workflow Clarity

Six clearly sequenced steps with explicit branching logic (source doc found vs not, --approved flag, approval language detection). Step 4 serves as a validation/challenge checkpoint with a feedback loop (present issues → wait for response → update draft). Conditional skip logic is well-defined. The workflow handles edge cases like multiple source files and missing mocks.

3 / 3

Progressive Disclosure

References `template.md` but no bundle files are provided, so it's unclear if this reference resolves. The skill is moderately long (~100 lines of substantive content) and keeps everything inline rather than splitting detailed interview questions or the assessment table into separate files. For a skill of this complexity, the organization is adequate but the template reference is unresolvable.

2 / 3

Total

10

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
PagerDuty/ai-forward-planning
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.