CtrlK
BlogDocsLog inGet started
Tessl Logo

write-mrd

Generate a market requirements document (MRD) from a product idea and save it as Markdown under the current project's markdown/ directory. Use when the user asks to write, draft, create, produce, or refine an MRD, market requirements document, product opportunity document, market demand analysis, product idea validation document, or asks for "写 MRD", "市场需求文档", "产品立项文档", "产品机会分析", especially when input is only an idea and the output should be structured, visual, and decision-oriented.

69

Quality

85%

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

81%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-structured instruction skill with a validated 6-step workflow, concrete naming and saving rules, and correctly placed detail in real one-level-deep bundle files. Its few gaps are mild: minor redundancy between the self-check and writing rules, and no inline example distinguishing lightweight from full MRD output.

DimensionReasoningScore

Conciseness

The body is imperative and lean ("Start from the market problem, not the feature list"; "Write high-level capabilities, not button-level implementation") with no explanation of concepts Claude already knows. Minor redundancy exists — the self-check checklist restates several writing rules — so it matches anchor 4 (minor trimming possible) rather than anchor 5 (every token earns its place), and is well above anchor 3.

4 / 5

Actionability

Concrete, executable guidance throughout: exact file-naming patterns ("markdown/<产品或主题>-MRD-<YYYYMMDD>.md"), SVG naming ("figure-1.svg"), explicit pointers to references/mrd-playbook.md and assets/mrd-template.md (both exist), and a fallback rule ("write 'market data pending verification' rather than inventing numbers"). For an instruction-only skill this matches anchor 4; it falls short of 5 only because depth-selection criteria and visual choices are described without a concrete inline example.

4 / 5

Workflow Clarity

A clearly sequenced 6-step workflow (normalize → choose depth → build argument → add visuals → save → self-check) culminating in an explicit validation step: "Self-check before final response" with a concrete checklist covering answered questions, no PRD drift, at-least-one-visual, named assumptions, and file existence. This matches anchor 5 (clear sequence with explicit validation steps and a checklist).

5 / 5

Progressive Disclosure

Both referenced bundle files (references/mrd-playbook.md for writing logic, assets/mrd-template.md for the output skeleton) exist, are one level deep, and are clearly signaled with paths. Sections are well-organized (Purpose, Inputs, Workflow, Rules, Optional Research, Final Response). It sits between anchors 4 and 5: references are embedded inside a workflow step rather than presented in a dedicated navigation section, and the template is qualified with "when useful" — so 4 is the best fit.

4 / 5

Total

17

/

20

Passed

Description

90%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 with explicit what/when structure, third-person voice, and exceptionally comprehensive bilingual trigger coverage. The only weakness is modest specificity of capabilities — it states the core action and output location but not the fuller set of concrete actions the skill performs.

Suggestions

List 2-3 more concrete actions in the description (e.g., 'choose lightweight or full MRD depth, embed Mermaid diagrams, research and cite current market data') to move specificity from 1-2 actions toward comprehensive coverage.

Briefly distinguish the skill from adjacent document types in the description (e.g., 'for go/no-go market decisions, not feature-level PRDs') to sharpen distinctiveness for users who might conflate MRD with PRD requests.

DimensionReasoningScore

Specificity

"Generate a market requirements document (MRD) from a product idea and save it as Markdown under the current project's markdown/ directory" names the domain and 1-2 concrete actions (generate, save to a location), but does not enumerate several specific actions like diagram creation, depth selection, or web research. This matches anchor 3 (1-2 concrete actions, not comprehensive) rather than anchor 4, which requires a list of several specific actions.

3 / 5

Completeness

Explicitly answers "what" ("Generate a market requirements document (MRD) from a product idea and save it as Markdown under the current project's markdown/ directory") and "when" ("Use when the user asks to write, draft, create, produce, or refine an MRD...") with concrete trigger phrases. This matches anchor 5 exactly; anchor 4 would apply only if the 'when' clause were less explicit.

5 / 5

Trigger Term Quality

Covers comprehensive natural trigger terms including verb variations ("write, draft, create, produce, or refine"), document-type synonyms ("MRD, market requirements document, product opportunity document, market demand analysis, product idea validation document"), and bilingual variants ("写 MRD", "市场需求文档", "产品立项文档", "产品机会分析"). This matches anchor 5's comprehensive coverage of natural terms and synonyms.

5 / 5

Distinctiveness Conflict Risk

MRD generation is a clear niche with distinct triggers in both English and Chinese, and the description names the specific document types; overlap risk with generic document or PRD skills is minimal. Matches anchor 5 (clear niche with distinct triggers), not anchor 4 (which implies notable overlap with closely related skills).

5 / 5

Total

18

/

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository
digoal/blog
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.