CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

generate-prd

Generate product requirements documents with optional publishing to Confluence or other wiki platforms

Quality

66%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/generate-prd/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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-structured, highly actionable skill with a clear phased workflow, explicit approval gates, and strong fallback/error handling. Its main weaknesses are an inline ~170-line PRD template that belongs in a reference file, placeholder-level publishing instructions, and a few redundant restatements. Tightening those would push most dimensions to 4-5.

Suggestions

Move the full PRD template to references/prd-template.md and keep only section names plus the frontmatter snippet inline — this improves both progressive_disclosure and conciseness.

Replace the '[CUSTOMIZE: ...]' publishing placeholders with concrete, executable request examples (including auth handling and a curl/WebFetch call) for at least Confluence, or move per-platform details to references/publishing.md.

Add explicit verification steps: confirm the saved PRD file exists and parses, and verify the published URL/status after publishing, to close the workflow_clarity gap.

Remove duplicated fallback statements (the 'no wiki platform active' case appears in both the Pre-Flight Check and the Fallback table) and drop the Phase 4 section re-enumeration.

DimensionReasoningScore

Conciseness

The body mostly respects Claude's competence (no explanation of what a PRD is, direct commands throughout), but tightening is needed beyond minor trims: 'If none active, PRD stays in the vault only (still fully useful)' appears in the Pre-Flight Check and again nearly verbatim in the Fallback table, and the Phase 4 gate re-enumerates all nine PRD sections already shown in the template. This fits 'Mostly efficient but includes some unnecessary explanation or could be tightened'; it is not 4 because the redundancy is more than a couple of minor instances.

3 / 5

Actionability

Guidance is mostly executable: exact glob patterns ('04-projects/*/PRDs/*.md'), runnable commands ("date '+%Y-%m-%d %H:%M'", 'mkdir -p "04-projects/[project]/PRDs"', 'gh search issues ... --json ... --limit 15'), and a complete PRD template. Not 5: the publishing steps are placeholder-heavy and not copy-paste ready — 'POST /wiki/rest/api/content' with '[CUSTOMIZE: YOUR-SPACE-KEY]' and 'Convert markdown to Confluence XHTML storage format' give no executable request or auth handling.

4 / 5

Workflow Clarity

A clear phased sequence (Pre-Flight Check → Phases 1–6) with an explicit review-gate checkpoint, a 'NEVER auto-publish' approval gate, and fallback/error-handling tables that provide feedback loops (API failure → save to vault, provide content for manual publishing). Not 5: validation relies on user approval rather than explicit verification steps — there is no check that the saved file is correct or that publishing succeeded (e.g., confirming the returned page URL).

4 / 5

Progressive Disclosure

Section structure is good (## headers, tables, code blocks) and the skill is a single file with no bundle directories, but content that clearly belongs in a separate reference file is inlined — the ~170-line PRD template (roughly half the file) and the per-platform publishing details would fit references/prd-template.md and references/publishing.md. This matches 'Some structure but could be better organized; content that should be separate is inline'; it is not 2 because the structure and navigation are solid, and the under-50-line exception for a 5 clearly does not apply.

3 / 5

Total

14

/

20

Passed

Description

53%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 states a clear, moderately specific capability but omits any 'when to use' guidance and the key acronym/synonyms ('PRD', 'spec') that users would naturally say. Distinctiveness is decent because PRD generation is a recognizable niche. Adding a trigger clause and natural synonyms would move most dimensions up a level.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when the user asks for a PRD, product spec, or requirements document before starting development' — this lifts completeness from 3 to 4-5.

Include the natural synonyms users actually say — 'PRD', 'product spec', 'requirements doc' — to raise trigger_term_quality and specificity.

Optionally name one more concrete capability (e.g. 'saves PRDs to your project vault') to round out the action list toward comprehensive coverage.

DimensionReasoningScore

Specificity

Names the domain ('product requirements documents') with two concrete actions — generating PRDs and 'optional publishing to Confluence or other wiki platforms' — but coverage is not comprehensive (no mention of saving to a vault, drafting from related issues, or review gates). This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; it is not 4 because only two actions are listed with clear coverage gaps.

3 / 5

Completeness

The 'what' is clear ('Generate product requirements documents... publishing to Confluence or other wiki platforms') but there is no 'Use when...' clause or any trigger guidance, which the rubric explicitly caps at 3. It is not 4 because 'when' is entirely absent rather than merely implicit or underspecified.

3 / 5

Trigger Term Quality

Relevant keywords exist ('product requirements documents', 'Confluence', 'wiki platforms') but the most natural synonym users say — 'PRD' — is absent, along with 'spec', 'product spec', and 'requirements doc'. This fits 'Some relevant keywords but missing common variations or synonyms'; it is not 4 because the missing terms are the common variations, not just a few extras.

3 / 5

Distinctiveness Conflict Risk

'Product requirements documents' plus wiki publishing is a fairly distinct niche with minor overlap risk against generic document-writing or note-publishing skills. It is not 5 because the wording leans formal ('wiki platforms') rather than pairing the niche with distinct natural trigger phrases.

4 / 5

Total

13

/

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

huytieu/COG-second-brain

Path

.claude/skills/generate-prd/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.