CtrlK
BlogDocsLog inGet started
Tessl Logo

craft-spec

Turn messy ideas into a clear, structured PRD. Use when you have rough notes, Slack threads, or half-formed ideas that need to become a product requirements document.

71

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a lean, actionable prompt template with a clear section structure and no unnecessary explanation, scoring well across all four dimensions. It suits a simple single-purpose skill well.

DimensionReasoningScore

Conciseness

The body is lean: a short intro, a single copy-paste prompt template, and a brief Tips list, with no padding explaining what a PRD is or how libraries work. It stays below the verbose anchor-1 and anchor-2 levels and assumes Claude's competence.

3 / 3

Actionability

The prompt template is fully executable with $ARGUMENTS, a fallback question, an explicit six-section PRD structure, and concrete tone directives ("Prefer short sentences", "Flag assumptions"), matching the copy-paste-ready anchor-3 example for an instruction skill.

3 / 3

Workflow Clarity

This is a simple single-task skill (run the template to produce a PRD) where the single action is unambiguous; per the simple-skills note, workflow clarity can score 3 without an explicit multi-step sequence, and the Tips section adds a light iterate-then-refine step.

3 / 3

Progressive Disclosure

The skill is under 50 lines with no need for external references, and its content is split into clearly labeled sections (Prompt Template, Tips), so well-organized sections alone meet anchor 3 per the under-50-lines guideline.

3 / 3

Total

12

/

12

Passed

Description

75%

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 cleanly covers what the skill does and when to use it with an explicit trigger clause, giving strong completeness and distinctiveness. It is slightly held back by listing only one transform action and by limited trigger-term variation.

Suggestions

Add a couple of concrete sub-actions (e.g. "shape notes into a structured PRD, draft user stories, surface open questions") to lift specificity toward anchor 3.

Broaden trigger terms with common synonyms users say, such as "write a spec", "requirements doc", or "feature spec", to improve trigger-term coverage.

DimensionReasoningScore

Specificity

"Turn messy ideas into a clear, structured PRD" names the domain (PRD) and a single transform action, but does not enumerate multiple specific concrete actions like the anchor-3 example ("extract text, fill forms, merge documents"). It is above the vague anchor-1 level because the action and output are concrete.

2 / 3

Completeness

It states what it does ("Turn messy ideas into a clear, structured PRD") and gives an explicit "Use when you have rough notes, Slack threads, or half-formed ideas..." trigger, satisfying both the what and the when at anchor 3.

3 / 3

Trigger Term Quality

"rough notes, Slack threads, or half-formed ideas" are natural phrases a user might say, but the description relies on one framing and lacks common synonyms/variations (e.g. "write a spec", "requirements doc", "feature spec") that the anchor-3 example lists in abundance.

2 / 3

Distinctiveness Conflict Risk

The PRD/spec-writing niche is clear and its triggers (rough notes, Slack threads, half-formed ideas → PRD) are distinct enough that it is unlikely to fire for unrelated skills.

3 / 3

Total

10

/

12

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.

Validation15 / 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
amplitude/builder-skills
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.