CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

write-brd

输入一个产品 idea(一句话或详细描述均可),自动生成图文并茂、结构完整的 BRD(商业需求文档),以 Markdown 格式保存到当前项目 markdown/ 目录,同时输出配套 SVG 图表文件。触发条件:用户提到"写 BRD"、"帮我写需求文档"、"生成 BRD"、"写商业需求文档"、"我有个产品想法"、"帮我把这个 idea 写成文档"、"PRD/BRD 模板"、"产品立项文档"。即使用户只给出一句简短的产品描述如"我想做一个 XX 产品",也应立即使用本 skill 生成 BRD。本 skill 面向产品经理、创业者、产品负责人,输出可直接用于团队评审和立项决策的专业文档。

64

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 skill delivers an unusually actionable, well-sequenced workflow with a complete copy-paste-ready template, concrete naming conventions, and useful post-generation quality checklists. Its main weaknesses are token weight — a huge inlined template with boilerplate rows and a redundant flow diagram — and a monolithic single-file structure that inlines content (especially the BRD template) that belongs in a separate reference file, plus a missing explicit validate-and-fix loop around the quality checklists.

Suggestions

Move the full BRD template (Step 4) into a references/brd-template.md file and keep only a section outline plus the file-naming rule in SKILL.md, cutting SKILL.md's token footprint roughly in half while preserving one-level-deep progressive disclosure.

Trim boilerplate inside the template (fully-populated RACI matrix, resource and milestone tables with placeholder rows) to just the row patterns Claude should follow, and drop the ASCII workflow diagram since the numbered Step sections already convey the sequence.

Add an explicit validation loop after Step 4: instruct Claude to run the 写作质量标准 checklists against the generated document and re-generate or fix any failing section (especially SVG file existence and correct Markdown references) before reporting completion.

DimensionReasoningScore

Conciseness

The body is mostly task-relevant and does not explain concepts Claude already knows, but it is noticeably heavy: a ~185-line full BRD template is inlined inline (including fully populated boilerplate rows like the RACI matrix, resource table, and milestone table with placeholder dates), and the workflow is stated twice (ASCII flow diagram plus the step sections). This fits the 3 anchor ("mostly efficient but... could be tightened") rather than 2, since nearly all content is skill-specific rather than filler, and rather than 4 because the template's boilerplate rows add real token cost without instruction value.

3 / 5

Actionability

Guidance is highly concrete for an instruction-only skill: exact file-naming conventions ("[product-name-en]-brd.md", "[product-name]-architecture.svg"), a concrete SVG tech spec (viewBox, font stack, hex palette), a full copy-paste-ready BRD template, and specific search-keyword formats ("[产品领域] market size"). It stops short of 5 only because the two mandatory SVG charts — a core deliverable — get a style spec but no example markup or structural skeleton to anchor generation.

4 / 5

Workflow Clarity

The four-step sequence is clear, ordered, and visualized in an overview diagram, and the "写作质量标准" checklists function as post-generation validation checkpoints (e.g., verifying SVGs are saved as files and referenced correctly). It does not reach 5 because the checklists lack an explicit feedback loop — nothing instructs re-checking or fixing output when a checklist item fails — leaving checkpoints implicit rather than enforced.

4 / 5

Progressive Disclosure

The body has good section structure (workflow, steps, template, quality checks, scenarios, triggers), but it is a monolithic SKILL.md with no reference files: the full BRD template, the SVG chart specifications, and the special-scenario handling are all inlined when the template in particular clearly belongs in a separate references/ file. This matches the 3 anchor ("some structure... content that should be separate is inline") rather than 2, because organization and navigation within the file are solid.

3 / 5

Total

14

/

20

Passed

Description

91%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 strong: it explicitly states what the skill does and when to use it, with an unusually thorough set of natural trigger phrases including an edge case for minimal one-sentence input. Its only weaknesses are mild padding ("图文并茂、结构完整") and a couple of trigger phrases broad enough to overlap with generic document-writing or PRD skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "自动生成图文并茂、结构完整的 BRD", "以 Markdown 格式保存到当前项目 markdown/ 目录", "同时输出配套 SVG 图表文件" — with specific output formats and destinations. It falls just short of the 5 anchor because phrases like "图文并茂、结构完整" are mildly padded, and it stays at 4 rather than 3 because the actions named are specific and together cover the skill's full behavior.

4 / 5

Completeness

Both questions are answered explicitly: the "what" is stated up front (generate a complete BRD in Markdown with companion SVG charts to the markdown/ directory), and the "when" is given via a dedicated "触发条件:" clause with concrete trigger phrases and an explicit instruction to fire even on a one-sentence idea. Not 4 because the trigger guidance is already fully explicit, not merely adequate.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive and natural, including synonyms and variations users would actually say: "写 BRD", "帮我写需求文档", "生成 BRD", "我有个产品想法", "帮我把这个 idea 写成文档", "PRD/BRD 模板", "产品立项文档", plus an edge-case example "我想做一个 XX 产品". This matches the 5 anchor's requirement of natural terms including synonyms; nothing common appears missing.

5 / 5

Distinctiveness Conflict Risk

BRD generation is a clear niche with distinct, product-document-specific triggers ("产品立项文档", "写商业需求文档"), so conflict risk is low — matching the 4 anchor of "mostly distinct; minor overlap risk". It does not reach 5 because broader phrases like "帮我把这个 idea 写成文档" and the inclusion of "PRD" could bleed into generic document-writing or PRD skills.

4 / 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: 2 missing

Warning

Total

15

/

16

Passed

Repository

digoal/blog

Path

skills/skills_for_claude_web/write-brd/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.