CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brainstorming

在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能、修改行为,或筹划任何新东西,无论是软件还是软件之外(一场分享、一门生意、一次装修)。

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/brainstorming/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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.

An exceptionally well-crafted instruction skill: concrete scripts, verbatim message templates, decision tables, feedback loops, and hard gates make the conversational workflow fully executable, and the body stays lean despite covering a complex multi-stage process. The one real defect is bundle integrity — the two files the body delegates to (builder-check-prompt.md, visual-companion.md) are missing, and the visual-companion scripts in scripts/ have no surviving entry point from SKILL.md.

Suggestions

Ship the missing builder-check-prompt.md and visual-companion.md alongside SKILL.md, or repoint those references to real files — currently the builder check and the visual companion are unusable as written.

Reference the scripts/ bundle from SKILL.md (e.g. in the visual-companion section: server start/stop via scripts/start-server.sh, scripts/stop-server.sh) so the five script files are discoverable.

Trim the motivational opening paragraph and the 'waterfall, very fast' aside — they explain context Claude can infer — to push conciseness toward lean.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious behavioral instruction (message composition rules, the ~200-300 char paraphrase spec, three-bucket question triage, size-judgment table) and mostly assumes competence rather than teaching basics. Minor padding could be trimmed — the motivational opening ("你非常擅长构建……这个'认为'通常比你感觉到的要单薄") and asides like "智能体做事是瀑布式的,只不过非常、非常快" — so anchor 4 ('efficient; minor instances of over-explanation') fits better than 5.

4 / 5

Actionability

For an instruction-only skill the guidance is copy-paste ready: the first message is specified as exactly two items in order with a quoted skip-offer, the visual-companion proposal is given verbatim ("要我打开一个浏览器标签页,放几个原型给你看吗?"), concrete question scripts are provided ("带我走一遍上一次……的经过"), a decision table maps work sizes to next steps, and the design doc path is fully specified (docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md). Per the rubric's code-vs-instruction note, absence of code is not penalized when guidance is this concrete; anchor 5 fits.

5 / 5

Workflow Clarity

The full lifecycle is clearly sequenced — first message → question loop with coverage areas → alternating paraphrase-back with confirmation → size judgment → written design → builder check → HARD-GATE → writing-plans — with explicit validation checkpoints and feedback loops: each paraphrase ends by asking "哪里不对或漏了什么", the builder check is a validation pass with a triage protocol and one bounded round of follow-up questions, and the danger-signals table plus HARD-GATE act as checklists. Anchor 5 ('explicit validation steps; feedback loops; checklists') matches; not 4 because no significant checkpoint is missing.

5 / 5

Progressive Disclosure

The SKILL.md itself is well-sectioned and its references are clearly signaled and one level deep, but scored against the actual bundle both referenced paths are broken: "用本目录下的 builder-check-prompt.md 派发一个全新的子代理" and "先阅读本目录下的 visual-companion.md" point to files that do not exist in the bundle, and the five files in scripts/ (server.cjs, start-server.sh, stop-server.sh, helper.js, frame-template.html) are never referenced from SKILL.md at all. Navigation fails at exactly the delegation points, so anchor 3 ('some structure; references present but problematic') fits; not 4 because runtime navigation to referenced files is broken, and not 2 because the body itself is not monolithic and the split into a lean overview plus detail files is the right design in principle.

3 / 5

Total

17

/

20

Passed

Description

48%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, explicit trigger description with good natural keyword coverage in both software and non-software contexts, but it is entirely one-sided: it tells Claude exhaustively when to fire and nothing about what the skill actually does. Adding a one-clause capability statement (question-driven clarification that ends in an approved written description/design) would lift completeness and specificity substantially.

Suggestions

State the 'what' explicitly, e.g. "通过逐题追问弄清对方真正想要什么和为什么,产出一份获批的书面设计" before the trigger clause — currently only 'when' is present.

Include common invocation synonyms as explicit triggers (头脑风暴、想法/idea、设计新东西、需求梳理) alongside the current activity-based triggers.

Narrow the opening claim ('must be used before ANY creative work, software or not') or explicitly position it relative to adjacent skills like writing-plans to reduce conflict risk.

DimensionReasoningScore

Specificity

The description enumerates concrete scenarios ("创建功能、构建组件、添加功能、修改行为,或筹划任何新东西") which are specific and well-scoped, but it never states any action the skill itself performs. It names the domain richly yet the capability side is thin, matching anchor 3 ('names domain and concrete items but not comprehensive') rather than 4 ('several specific actions' would require the skill's own actions to be listed).

3 / 5

Completeness

The 'when' is explicit and comprehensive ("在任何创造性工作之前必须使用此技能" plus an enumerated list), but the 'what' is entirely absent — the description says only when to invoke the skill, never what it does (e.g. runs a question-driven conversation, produces a written design). Scoring only what is explicitly stated, this matches anchor 2's 'only when is present without what'; it is not 3 because there is no clear 'what' even implicitly in the description text, and not above 2 for the same reason.

2 / 5

Trigger Term Quality

Natural trigger phrases cover the main invocation scenarios users would actually voice — "创建功能", "构建组件", "添加功能", "修改行为", "筹划任何新东西" — and extend beyond software ("一场分享、一门生意、一次装修"). A few natural terms are missing (e.g. 头脑风暴/brainstorm, 想法, 设计 as explicit triggers), fitting anchor 4 rather than 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The trigger is scoped (pre-creation timing, creative/new work, excluding e.g. bug fixes and analysis) but claims that entire territory — "在任何创造性工作之前必须使用" — creating overlap risk with planning, design, and requirements-gathering skills (the body itself delegates to writing-plans). 'Somewhat specific but could still overlap with similar skills' (anchor 3) fits; not 4 because the 'any new thing, software or not' framing is very broad.

3 / 5

Total

12

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

jnMetaCode/superpowers-zh

Path

skills/brainstorming/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.