CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prd-writer

Generate comprehensive product requirements documents. Use when starting a new feature or product initiative and need structured documentation.

Quality

68%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/prd-writer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 a serviceable, reasonably organized single-purpose prompt template with a clear PRD outline and a concrete example. Its weaknesses are fluff in the framing sections, duplicated trigger guidance, and instructions that restate a generic prompt with an unresolved placeholder rather than adding PM-specific expertise.

Suggestions

Delete the "Domain Context" marketing copy ("proven framework", "best practices from industry leaders") and merge the duplicated When-to-Use bullets into one section under a single top-level heading.

Replace the "Your context: [Add product context...]" placeholder with an explicit instruction for how to gather or proceed without input context, and add one short worked example of an output section (e.g. a sample success-metrics block).

Add skill-specific value Claude wouldn't generate on its own — e.g. a preferred PRD format, acceptance-criteria patterns, or in-scope/out-of-scope conventions — instead of restating standard PRD structure.

DimensionReasoningScore

Conciseness

The PRD section outline and example are tight, but fluff like "implements a proven product management framework... combines best practices from industry leaders" adds nothing Claude doesn't know, and the "When to Use" section duplicates the frontmatter description. Mostly efficient with some unnecessary explanation that could be trimmed, matching anchor 3 rather than the noticeably padded level 2.

3 / 5

Actionability

The Instructions section provides a concrete five-part PRD outline and the Example shows a specific input/output pair, but the guidance largely restates PRD structure Claude already knows, and the unresolved placeholder "[Add product context, feature details, and constraints here]" leaves a hole. Some concrete guidance but incomplete, fitting anchor 3 rather than the mostly-executable level 4, which would require a filled template or worked example.

3 / 5

Workflow Clarity

As a simple single-purpose skill the action is unambiguous: take the user's context and produce a PRD with the listed sections, applying the best-practices tips. Sequence and intent are clear with only minor gaps (e.g. no guidance when input context is missing), and no destructive or batch operation is involved so no validation checkpoint is required — matching anchor 4 rather than 5, which expects explicit checkpoints or feedback loops.

4 / 5

Progressive Disclosure

The body is short with well-labeled sections (When to Use, Instructions, Best Practices, Example, Further Reading) and no nested or buried references, so inline placement is appropriate. Minor organization gaps keep it from anchor 5: the heading hierarchy is inverted (## Domain Context appears before the # PRD Writer H1), the When-to-Use/Domain Context material is split across two competing structures, and Further Reading links to external blog posts rather than navigable skill material.

4 / 5

Total

14

/

20

Passed

Description

62%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.

The description answers both what and when in third person and is concise, but it under-specifies the skill's capabilities and omits the most natural trigger term, "PRD". Trigger quality and specificity are the main gaps.

Suggestions

Include the acronym users actually say, e.g. "Use when the user asks for a PRD, product requirements document, or requirements spec for a new feature."

Name the concrete components produced (e.g. problem statement, user stories, functional requirements, success metrics) instead of the filler word "comprehensive".

Tighten the when-clause grammar ("...and needs structured documentation") and add a couple of concrete trigger phrases such as "document requirements for engineering".

DimensionReasoningScore

Specificity

"Generate comprehensive product requirements documents" names the domain and one concrete action, but "comprehensive" is padding and no document components (problem statement, requirements, success metrics) are mentioned. This matches the anchor for naming a domain with 1-2 concrete actions, not the several-specific-actions level above.

3 / 5

Completeness

Both parts are explicit: what ("Generate comprehensive product requirements documents") and when ("Use when starting a new feature or product initiative and need structured documentation"). The 'when' clause is present but generic and lacks concrete trigger phrases, matching the anchor where 'when' could be more explicit — not level 5, which requires concrete trigger phrases, and not level 3, since 'when' is explicit rather than implied.

4 / 5

Trigger Term Quality

Triggers like "starting a new feature" and "product initiative" are natural, but the most common phrasing users would say — the acronym "PRD" — is absent, along with variations like "requirements doc" or "spec". Keyword coverage is relevant but missing common synonyms, fitting the middle anchor rather than good coverage.

3 / 5

Distinctiveness Conflict Risk

The PRD-writing niche is fairly distinct with clear triggers around new features and product initiatives; overlap risk is limited to closely related documentation/spec-writing skills. Mostly distinct with minor overlap, fitting anchor 4 rather than 5, which demands a clearer niche with distinct trigger terms like the "PRD" acronym.

4 / 5

Total

14

/

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

saski/arnesto

Path

.agents/skills/prd-writer/SKILL.md

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.