CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

to-prd

Turn the current conversation context into a PRD and publish it to the project issue tracker. Use when user wants to create a PRD from the current context.

86

1.50x
Quality

84%

Does it follow best practices?

Impact

98%

1.50x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is to-prd in coder/agent-tty

SKILL.md
Quality
Evals
Security

Quality

Content

86%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-crafted instruction-only skill: the PRD template is complete and copy-paste ready, the process is clearly sequenced with user check-in points, and the file is compact and well organized. The only minor gaps are a slightly redundant deep-module definition and the absence of a pre-publish completeness check on the generated PRD.

DimensionReasoningScore

Conciseness

The body is mostly lean and directive, but the deep-module definition ("A deep module (as opposed to a shallow module) is one which encapsulates a lot of functionality in a simple, testable interface which rarely changes") explains a software-design concept Claude already knows, and the opening line "This skill takes the current conversation context and codebase understanding and produces a PRD" restates the frontmatter description.

4 / 5

Actionability

The guidance is fully executable for an instruction-only skill: a complete PRD template with concrete section names, an explicit user-story format ("As an <actor>, I want a <feature>, so that <benefit>"), a copy-paste example user story, and specific directives like "Apply the `needs-triage` triage label" and "respect any ADRs in the area you're touching".

5 / 5

Workflow Clarity

A clear numbered 3-step sequence (explore repo, sketch modules, write and publish) with explicit user-confirmation checkpoints ("Check with the user that these modules match their expectations. Check with the user which modules they want tests written for."), but there is no validation step confirming the PRD is complete against the template before publishing it to the issue tracker.

4 / 5

Progressive Disclosure

A single, short, well-sectioned file with no external references needed; the PRD template is clearly delimited with <prd-template> tags and appropriately inline, and the only cross-reference ("run `/setup-matt-pocock-skills` if not") is clearly signaled and one level deep.

5 / 5

Total

18

/

20

Passed

Description

75%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 solid description that explicitly and concisely answers both what the skill does and when to use it, in third person, with a clear niche and low conflict risk. Its main weaknesses are narrow action coverage and a thin trigger vocabulary that misses common synonyms for PRD.

Suggestions

Add one or two more concrete actions to the description (e.g., applying the `needs-triage` label or structuring extensive user stories) to move from two actions toward the several-action anchor.

Broaden the trigger vocabulary with natural synonyms users would say, such as "product requirements document", "requirements doc", or "write a PRD/spec from this conversation".

DimensionReasoningScore

Specificity

"Turn the current conversation context into a PRD and publish it to the project issue tracker" names the domain and exactly two concrete actions (synthesize a PRD, publish to the tracker), matching the 1-2-actions anchor; anchor 4 requires several specific actions (its example lists three), and the description does not mention e.g. applying triage labels or structuring user stories.

3 / 5

Completeness

It clearly answers both what ("Turn the current conversation context into a PRD and publish it to the project issue tracker") and when ("Use when user wants to create a PRD from the current context") with a concrete, natural trigger phrase; anchor 4's caveat that the when "could be more explicit or specific" does not apply since the trigger clause is fully explicit.

5 / 5

Trigger Term Quality

"create a PRD" is a natural phrase users would say, but the description omits common variations and synonyms such as "product requirements document", "requirements doc", or "spec", matching the anchor for some relevant keywords with missing variations.

3 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — synthesizing a PRD from conversation context and publishing it to the project issue tracker — with a distinct trigger ("create a PRD") that is unlikely to collide with other skills' triggers.

5 / 5

Total

16

/

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

SnowingFox/ai-skills

Path

.agents/skills/to-prd/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.