CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

to-prd

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

63

0.00x
Quality

73%

Does it follow best practices?

Impact

0%

0.00x

1 of 3 eval scenarios. Add 2 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/to-prd/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 tight, actionable instruction set: a three-step process with a user checkpoint, a complete PRD template with a worked user-story example, and explicit inclusion/exclusion rules for content. The only real weaknesses are minor wording redundancy and the absence of a post-publish verification step.

DimensionReasoningScore

Conciseness

The body is lean — directives like "Do NOT interview the user — just synthesize what you already know" and "Existing seams should be preferred to new ones. Use the highest seam possible" assume Claude's competence with no concept explanations. It falls just short of anchor 5 due to minor redundancy such as "A LONG, numbered list" followed by "should be extremely extensive and cover all aspects".

4 / 5

Actionability

Concrete, executable guidance throughout: a full PRD template with named sections, an exact user-story format ("As an <actor>, I want a <feature>, so that <benefit>") with a worked example, and explicit rules ("Apply the `ready-for-agent` triage label", "Do NOT include specific file paths"). It matches anchor 4: mostly executable with a minor gap — the mechanics of publishing to the issue tracker are deferred to externally provided vocabulary.

4 / 5

Workflow Clarity

A clear three-step sequence (explore repo → sketch seams → write and publish) with an explicit human checkpoint: "Check with the user that these seams match their expectations." This fits anchor 4 (clear sequence, most checkpoints present); it is not a 5 because there is no verification step after publishing, and not a 3 because the user-checkpoint is an explicit validation gate on the riskiest decision.

4 / 5

Progressive Disclosure

No bundle files exist and none are needed: this single-purpose skill (~75 lines) keeps its only reusable artifact, the PRD template, inline where it is used every invocation, with well-organized sections (Process, template) and no nested references. Per the simple-skill scoring note, well-organized sections with no external-reference needs warrant a 5; it is not penalized for the absence of references it does not need.

5 / 5

Total

17

/

20

Passed

Description

53%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 states a clear, concrete purpose with a distinctive angle (synthesis without interview), but lacks any 'Use when...' trigger guidance and misses natural synonyms like 'product requirements document' or 'spec'. It is serviceable for a user-invoked skill but below the rubric's bar for a complete, trigger-rich description.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to turn this conversation/discussion into a PRD, spec, or product requirements document.'

Include natural synonyms and phrasings users would actually say ('write a PRD', 'capture this as a spec') to broaden trigger-term coverage.

Optionally state the outcome location more concretely (e.g. which tracker/label the PRD is published with) to sharpen distinctiveness.

DimensionReasoningScore

Specificity

Quotes: "Turn the current conversation into a PRD" and "publish it to the project issue tracker" — the domain is clearly named with two concrete actions. It stays at anchor 3 rather than 4 because only two actions are listed ('several specific actions' is not met), though they are stated crisply; it is well above anchor 2 since the actions are concrete, not generic.

3 / 5

Completeness

The 'what' is clear (synthesize a PRD from the conversation and publish it), but there is no 'Use when...' or equivalent trigger clause, which per the judging guidelines caps completeness at 3. This exactly matches anchor 3: 'Has a clear what but when is missing or only weakly implied.'

3 / 5

Trigger Term Quality

Relevant keywords like "PRD", "conversation", and "issue tracker" are present, but common variations users would say ("product requirements document", "spec", "write up this discussion") are missing. It fits anchor 3 ('some relevant keywords but missing common variations or synonyms') better than 4, which requires broader natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

Quotes: "Turn the current conversation into a PRD" with "no interview, just synthesis" carves a clear niche that is unlikely to collide with general writing or issue-management skills. It sits between anchors 4 and 5: mostly distinct with minor overlap risk, but the absence of explicit trigger phrases keeps it from a 5.

4 / 5

Total

13

/

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

coder/agent-tty

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.