CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spec

Writes (or rewrites) a spec, PRD, PR-FAQ or shaped pitch and grades it against what the best product teams actually do. Use when you ask 'write a PRD', 'how do I spec this', 'PR/FAQ', 'working backwards doc', 'shape this project', 'do we even need a PRD', or 'engineering says the spec isn't detailed enough'. Draws on 56 insights from 38 Lenny's Podcast guests incl. Ryan Singer, Bill Carr and Lane Shackleton.

Quality

93%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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-engineered instruction skill: routing table, five concrete plays, an expert-disagreement section with defaults, a deliverable template, and an embedded grading rubric. The only improvements are trimming the duplicated quote content and the repeated framing line.

DimensionReasoningScore

Conciseness

Dense with non-generic specifics (named guests, "fewer than 10 moving pieces", timestamped quotes) and no explanation of concepts Claude already knows, but minor padding exists: "56 insights from 38 Lenny's Podcast guests" repeats the frontmatter in the intro, and the Receipts section duplicates content already delegated to references/quotes.md. Not 5 because a few sections could be trimmed; not 3 because there is no over-explanation.

4 / 5

Actionability

Fully actionable for an instruction-only skill: a diagnose step capped at "max 4" questions, a situation→play routing table, numbered per-play steps, a fill-in deliverable template, and a 1/3/5-anchored grading rubric ending in "top 3 fixes". Specific guidance covers the common cases.

5 / 5

Workflow Clarity

Clear sequence (Diagnose → Pick the play → Run it → Deliverable → Grade → top 3 fixes) with explicit validation checkpoints and feedback loops: "Stop when it passes two tests... If not, keep shaping" and "Shaped output test: engineer <name> confirmed... yes/no" in the deliverable. The grading rubric acts as a checklist.

5 / 5

Progressive Disclosure

Well-signaled, one-level-deep references that exist on disk ("references/frameworks.md: every framework in this skill, how to run it"; "references/quotes.md: verified quotes with timestamps"), plus related-skill handoffs. Not 5 because the inlined Receipts quotes duplicate references/quotes.md, content that belongs in the referenced file only.

4 / 5

Total

18

/

20

Passed

Description

95%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: concrete actions, explicit 'Use when' triggers in natural user language, third-person voice, and a clearly staked-out niche. The only weakness is that the grading action is stated without saying what the grading yields.

DimensionReasoningScore

Specificity

"Writes (or rewrites) a spec, PRD, PR-FAQ or shaped pitch" and "grades it" list several concrete actions with named artifact types, matching the 'several specific actions; minor gaps' anchor. Not 5 because "grades it against what the best product teams actually do" leaves the grading mechanism and output unspecified; not 3 because more than 1-2 actions are named.

4 / 5

Completeness

Explicitly answers both: what ("Writes (or rewrites) a spec, PRD, PR-FAQ or shaped pitch and grades it") and when ("Use when you ask 'write a PRD'...") with concrete trigger phrases, in third-person voice. Matches the top anchor exactly.

5 / 5

Trigger Term Quality

The trigger list — 'write a PRD', 'how do I spec this', 'PR/FAQ', 'working backwards doc', 'shape this project', 'do we even need a PRD', 'engineering says the spec isn't detailed enough' — comprehensively covers natural phrasings users would actually say, including synonyms (spec, PRD, PR-FAQ, working backwards).

5 / 5

Distinctiveness Conflict Risk

Clear niche (spec/PRD/PR-FAQ writing and grading) with distinct triggers like 'working backwards doc' and 'shape this project' that no adjacent skill would claim. Minimal conflict risk; not 4 because the triggers are niche-specific rather than merely 'mostly distinct'.

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

menkesu/awesome-pm-skills

Path

skills/spec/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.