CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prd-writing

Read before writing a PRD, design doc, or feature proposal. Covers challenging the idea before designing it, verifying every claim against actual code (not memory or a plugin's name/category), tracing every downstream consumer of a new mechanism, evaluating performance impact against the schema/indexes that actually exist, recording rejected alternatives and open-issue decisions explicitly, and a dedicated final-check pass before calling it done.

70

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 a superbly actionable, well-sequenced process with real validation checkpoints and error-recovery loops, grounded in concrete codebase specifics. Its weaknesses are token efficiency — nearly every step could be half its length — and the total absence of progressive disclosure, with all anecdotes and codebase detail inlined in the main file.

Suggestions

Move the multi-sentence war stories (the front/js/sse_manager.js indicator saga in 'When to use', the single-device DB fixture case in step 7) into a references/ file (e.g. references/failure-cases.md) and keep one-line pointers in the steps, cutting the main file substantially.

Tighten steps 7 and 10 to their core instructions: the red-test rationale and the production-scale/index reasoning can each be stated in 2-3 sentences instead of the current 10+ line paragraphs.

Split the codebase-specific catalog (CREATE INDEX examples, the three API surface paths, mylog()/write_notification() precedents) into a compact reference file so SKILL.md reads as a process overview rather than an inlined database.

DimensionReasoningScore

Conciseness

The body is dense with non-derivable project-specific knowledge (index names, file paths, failure cases) and never explains generic concepts, but most steps run 5-10+ lines with embedded anecdotes (e.g. "a real case: a single-device DB fixture passed against both the buggy and the fixed code") and long parenthetical asides that could be cut roughly in half without losing the instruction. It is not a 2 because nothing is generic padding, and not a 4 because substantial tightening is possible throughout steps 3, 7, and 10.

3 / 5

Actionability

For an instruction-only skill the guidance is fully executable: concrete commands ("Grep `CREATE INDEX` for *every* index", "`EXPLAIN QUERY PLAN` at a realistic row count"), real artifacts ("`test/db_test_helpers.py` fixtures", "`server/scan/presence.py`", "`idx_currentscan_scanmac`"), an exact save path, and a per-section document template. Specific examples cover the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

Thirteen clearly sequenced steps with explicit validation checkpoints ("confirm it fails for the right reason", the dedicated final-check pass in step 11, the implementation checklist) and error-recovery feedback loops ("the correct recovery is to actually revert the implementation, confirm the test fails red against the reverted code, and only then reapply the fix"). This matches the 5 anchor's explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

Everything lives in one ~75-line/18KB SKILL.md with no bundle files or references at all — the multi-sentence war stories (the `sse_manager.js` indicator saga, the DB-fixture case) and the codebase-specific catalog (index names, API surface paths) are inlined where a references file would keep the overview lean. It is not a 4 because no content is split out at all, and not a 2 because section structure is clear and nothing is buried or nested.

3 / 5

Total

16

/

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.

A strong description: it states an explicit trigger condition, enumerates concrete capabilities comprehensively in third-person voice, and occupies a distinct niche. The only weakness is moderate synonym coverage — a few natural variations like 'spec' or 'product requirements document' are absent.

DimensionReasoningScore

Specificity

The description enumerates seven concrete, distinct actions — "challenging the idea before designing it", "verifying every claim against actual code", "tracing every downstream consumer of a new mechanism", "evaluating performance impact against the schema/indexes that actually exist", "recording rejected alternatives and open-issue decisions", and "a dedicated final-check pass" — giving comprehensive coverage of the skill's process. It is not a 4 because coverage is comprehensive rather than having minor gaps, and it uses third-person voice throughout.

5 / 5

Completeness

"Read before writing a PRD, design doc, or feature proposal" is an explicit when-clause with concrete trigger phrases, and "Covers challenging the idea... a dedicated final-check pass" explicitly enumerates the what. Both questions are answered clearly and explicitly, matching the 5 anchor; the 4 anchor's weaker 'when' does not apply.

5 / 5

Trigger Term Quality

"writing a PRD, design doc, or feature proposal" provides good natural keyword coverage — phrases users would actually say. It is not a 5 because common synonyms and variations ("product requirements document", "spec", "RFC") are missing, but it clearly exceeds the 3 anchor's 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

PRD/design-doc/feature-proposal authorship is a clear niche with distinct, domain-specific triggers, so conflict risk with other skills is minimal. It is not a 4 because the triggers ("PRD", "design doc", "feature proposal") directly and uniquely name this domain rather than overlapping generically with 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

.claude/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.