CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pm-spec-writing

Translate ideas, feature requests, or vague concepts into specific, actionable dev briefs. Use this skill whenever the user has an idea they want to build, a feature to spec out, a bug to file, a project to scope, or needs to convert a half-formed idea into a clear implementation brief. Triggers on I want to add, we should build, can we make, what is the plan for, how do we implement, dev brief, feature spec, PRD, user story, acceptance criteria, scope this, prioritize. Also triggers when the user has a list of things they want to build and needs help converting them into well-formed tasks.

77

Quality

97%

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

100%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 lean, fully actionable instruction skill: it routes clearly, provides copy-paste templates for every output type, sequences the work with explicit feedback gates, and properly splits detail into real one-level-deep reference files. No section wastes tokens on general knowledge, and the failure-patterns checklist adds quality control.

DimensionReasoningScore

Conciseness

The ~224-line body is dense and functional throughout: routing (when/when-not), required inputs, the four clarification questions, the impact/effort grid with concrete examples, three condensed templates, a 7-step workflow, failure patterns, and output conventions. No section explains concepts Claude already knows, and every token earns its place.

5 / 5

Actionability

Copy-paste-ready templates for all three formats (feature spec, dev brief, bug report) with exact section names and placeholders, a concrete output file-naming convention ("spec-[feature-name].md"), folder structure example, and concrete testable-vs-untestable examples ("User completes signup in under 60 seconds"). For an instruction-only skill the guidance is fully actionable.

5 / 5

Workflow Clarity

The 7-step workflow is explicitly sequenced with feedback gates: "If the idea is vague, ask the four phase-1 questions before proceeding," "If any answer is 'I don't know,' go back to the user," "Empty sections are flags," and a buy-in review checkpoint before implementation. The failure-patterns section serves as a checklist. Spec writing is not a destructive/batch operation, so no validation cap applies.

5 / 5

Progressive Disclosure

Clear overview with condensed inline templates, and well-signaled one-level-deep references verified to exist: references/feature-spec-template.md and references/dev-brief-template.md contain the full template versions, and references/prioritization-frameworks.md moves RICE/MoSCoW/weighted scoring out of the body. This matches the anchor for clear overview with well-signaled one-level-deep references and easy navigation.

5 / 5

Total

20

/

20

Passed

Description

96%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 a strong example: it answers both what and when explicitly, uses natural trigger phrases users would actually say, and stays in third-person voice. The only weakness is a couple of overly broad trigger phrases that slightly raise conflict risk with general implementation or planning skills.

DimensionReasoningScore

Specificity

"Translate ideas, feature requests, or vague concepts into specific, actionable dev briefs" plus "a feature to spec out, a bug to file, a project to scope" lists multiple concrete actions with comprehensive coverage of the spec-writing domain (ideas, features, bugs, projects, backlogs), matching the anchor for multiple specific concrete actions. Voice is third-person imperative throughout, so no voice penalty applies.

5 / 5

Completeness

Both what ("Translate ideas, feature requests, or vague concepts into specific, actionable dev briefs") and when ("Use this skill whenever the user has an idea they want to build...") are explicitly and clearly answered with concrete trigger phrases, exactly matching the top anchor.

5 / 5

Trigger Term Quality

"Triggers on I want to add, we should build, can we make, what is the plan for, how do we implement, dev brief, feature spec, PRD, user story, acceptance criteria, scope this, prioritize" covers natural user phrasing, domain synonyms, and artifact names comprehensively. This is comprehensive coverage of natural terms including synonyms.

5 / 5

Distinctiveness Conflict Risk

The PM-spec-writing niche is clear and distinct from adjacent skills (the body even routes to roadmap-planning, code-review-web, ux-research), but very broad triggers like "how do we implement" and "prioritize" could fire for general implementation help or planning skills. Mostly distinct with minor overlap risk against closely related planning skills, matching the 4 anchor rather than the 5 anchor's minimal conflict risk.

4 / 5

Total

19

/

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

rampstackco/claude-skills

Path

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