CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prd-writing

Rigorous PRD-writing methodology — challenge the idea, verify every claim against actual code, trace every downstream consumer of a mechanism, evaluate performance impact against the schema/indexes that actually exist, record rejected alternatives and open-issue decisions explicitly, and do a dedicated final-check pass before calling it done. Use this when asked to write, draft, or review a PRD, design doc, or feature proposal for this codebase.

71

Quality

89%

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 prd-writing in netalertx/NetAlertX

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.

The body delivers exceptionally concrete, codebase-grounded process guidance with strong validation checkpoints, error-recovery loops, and checklists, but pays for it in length: several steps are dense run-on paragraphs with embedded anecdotes that could be tightened or moved to a reference file. There is no basic-concept padding — the verbosity is digressive detail, not explanation of things Claude already knows.

Suggestions

Tighten steps 3, 7, and 10 into short imperative directives with at most a one-line example each; move the extended failure anecdotes (the sse_manager.js three-cycle story, the named-index walk-through) into a references/ file cited once, keeping the process steps lean.

Split the 'Implementing an approved PRD' section and the real-case studies into a separate reference file (e.g. references/implementation.md) so SKILL.md reads as a scannable overview, and replace the unresolvable 'scan-pipeline Gotcha 8' pointer with the actual lesson stated inline.

Convert each long paragraph step into an action + check + one concrete example bullet structure, preserving the validation discipline while cutting the multi-clause digressions.

DimensionReasoningScore

Conciseness

The guidance is codebase-specific (real file paths, index names, failure modes) with no basic-concept padding, but steps 3, 7, and 10 are run-on paragraphs of 150+ words with embedded multi-sentence anecdotes ('A real case: a settings still applying indicator went through three full implementation-and-break cycles...'). Mostly efficient but could be tightened — the score-3 anchor; not 4, whose over-explanation is only 'minor instances', and not 2, since the anecdotes are concrete justifications rather than unnecessary explanations.

3 / 5

Actionability

Fully actionable instruction-only guidance: 'cite file:line for every claim', 'Grep CREATE INDEX for every index on the tables involved', 'EXPLAIN QUERY PLAN at a realistic row count', a concrete save path ('.gemini/internal-docs/PRDs/<kebab-case-name>.md'), a status-line format, a three-box implementation checklist, and named real functions (current_scan_presence_condition(), test/db_test_helpers.py). Matches the score-5 anchor's 'fully executable... specific examples cover the common cases'.

5 / 5

Workflow Clarity

A 13-step numbered process with explicit validation checkpoints (step 11's dedicated final-check bullet list, step 7's confirm-the-test-fails-red-for-the-right-reason), an error-recovery feedback loop ('revert the implementation, confirm the test fails red against the reverted code, and only then reapply the fix'), and checklists — an exact match for the score-5 anchor; no validation cap applies since verification is pervasive.

5 / 5

Progressive Disclosure

Single-file skill with no bundle (no references/, scripts/, or assets/ exist) and clear section headers throughout, so nothing is buried or nested. However, extended real-case anecdotes (the sse_manager.js story, the index examples) and codebase-specific details are inlined in dense paragraph steps, and one pointer ('see scan-pipeline Gotcha 8') resolves to nothing shipped with the skill. Good structure with minor organization gaps — the score-4 anchor; not 5, which expects a lean overview split across files, and not 3, since the inline material is justification rather than clearly-separate reference content.

4 / 5

Total

17

/

20

Passed

Description

92%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 is comprehensive and concrete: it names seven specific actions spanning the full PRD-writing lifecycle and closes with an explicit 'Use this when...' clause containing natural trigger phrases. The only gap is a few missing keyword variations such as 'spec out' and the expanded 'product requirements document'.

DimensionReasoningScore

Specificity

Lists seven concrete actions — 'challenge the idea', 'verify every claim against actual code', 'trace every downstream consumer of a mechanism', 'evaluate performance impact against the schema/indexes that actually exist', 'record rejected alternatives and open-issue decisions explicitly', 'do a dedicated final-check pass' — comprehensive coverage of the PRD-writing process. Fits the score-5 anchor ('multiple specific concrete actions; comprehensive coverage'), not score 4's 'minor gaps in coverage', since every phase of the methodology is named.

5 / 5

Completeness

Explicitly answers both what ('Rigorous PRD-writing methodology — challenge the idea, verify every claim against actual code...') and when ('Use this when asked to write, draft, or review a PRD, design doc, or feature proposal for this codebase') with concrete trigger phrases — an exact match for the score-5 anchor; not 4, whose 'when' is less explicit.

5 / 5

Trigger Term Quality

'write, draft, or review a PRD, design doc, or feature proposal' gives good natural verb and noun coverage, but misses common variations the skill body itself lists as triggers ('spec out this feature', 'product requirements document'). Good coverage with a few natural terms missing — the score-4 anchor, not 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'PRD', 'design doc', and 'feature proposal' form a clear niche with distinct, unlikely-to-misfire triggers; minimal overlap risk with generic writing or documentation skills — the score-5 anchor rather than 4's 'minor overlap risk with closely related skills'.

5 / 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

netalertx/NetAlertX

Path

.gemini/skills/prd-writing/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.