CtrlK
BlogDocsLog inGet started
Tessl Logo

write-brd

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

68

Quality

83%

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

75%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 highly actionable, well-structured skill body with a concrete workflow, exact SVG/BRD specs, and useful quality checklists. The main weaknesses are duplicated trigger examples and an inlined full template that slightly inflates token usage.

Suggestions

Remove the '触发示例' section or replace it with a pointer — the frontmatter description already lists the same triggers, so the duplication is pure token cost.

Move the full BRD template into a references/ file (e.g. references/brd-template.md) and keep only a condensed outline plus a link in SKILL.md to improve progressive disclosure.

Add an explicit validation checkpoint inside the workflow (e.g., run the '写作质量标准' checklist after Step 4 and regenerate any failing sections) to create a clear feedback loop.

DimensionReasoningScore

Conciseness

Mostly efficient and free of concepts Claude already knows, but the closing '触发示例' section duplicates the description's triggers and the ~180-line inlined BRD template could be tightened or externalized.

3 / 5

Actionability

Highly executable: a concrete 4-step workflow, exact SVG tech spec (viewBox, font-family, hex colors), search keyword formats, file-naming conventions, and a copy-paste-ready BRD template covering common cases.

5 / 5

Workflow Clarity

Clear sequenced 4-step flow with an overview diagram and a dedicated quality-checklist section acting as validation; lacks an explicit in-flow 'validate-then-fix-retry' feedback loop, leaving a minor checkpoint gap.

4 / 5

Progressive Disclosure

Well-organized with clear section headers and no nested references; the large inlined BRD template is the core deliverable spec so inline placement is defensible, though splitting it to a reference file would improve navigability.

4 / 5

Total

16

/

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.

A strong, concrete description with explicit what/when structure and rich natural trigger phrases in third-person voice. Minor overlap risk from the PRD mention and slightly less-than-comprehensive action listing keep it just off perfect.

Suggestions

Consider dropping or narrowing the 'PRD/BRD 模板' trigger to reduce overlap with a potential PRD skill and sharpen the BRD-only niche.

Enumerate the concrete sub-actions more fully (e.g., infer assumptions, run web search, generate SVG diagrams, fill BRD template) to push specificity toward comprehensive coverage.

DimensionReasoningScore

Specificity

Lists several concrete actions — '自动生成…BRD', '以 Markdown 格式保存到当前项目 markdown/ 目录', '输出配套 SVG 图表文件' — with clear output targets; just shy of comprehensive coverage of all sub-actions.

4 / 5

Completeness

Explicitly answers both what (generate structured illustrated BRD as Markdown + SVG to markdown/) and when (a dedicated '触发条件' clause with concrete phrases, plus the '即使…也应立即使用本 skill' guidance).

5 / 5

Trigger Term Quality

Comprehensive natural trigger phrases including synonyms — '写 BRD', '帮我写需求文档', '生成 BRD', '写商业需求文档', 'PRD/BRD 模板', '产品立项文档', '我想做一个 XX 产品' — covering the ways users actually request this.

5 / 5

Distinctiveness Conflict Risk

BRD/立项文档 generation is a clear niche with distinct triggers, but the inclusion of 'PRD/BRD 模板' creates minor overlap risk with a hypothetical PRD-writing skill.

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 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.