brainstorming

在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/brainstorming/SKILL.md

Quality

Content

70%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, highly actionable process skill with excellent workflow clarity and validation feedback loops. Its main weakness is progressive disclosure: a referenced detail file is missing and the provided script bundle is not wired into the body.

Suggestions

Add the missing skills/brainstorming/visual-companion.md (or correct the reference path) so the signaled deep-dive actually exists, and mention the relevant scripts/ files (e.g. start-server.sh --open) from the visual-companion section so the bundle is navigable.

Remove or condense the DOT flowchart, since it restates the per-path checklists already in the 检查清单 section; the token savings would not lose information.

Trim the repeated approval-gate messaging to one canonical HARD-GATE statement plus one reminder, relying on the checklists to re-enforce it per path.

Dimension	Reasoning	Score
Conciseness	Mostly efficient, but the DOT flowchart substantially duplicates the per-path checklists and the approval-gate message is repeated across the HARD-GATE, anti-pattern, danger-signals, and checklist sections; both could be tightened.	3 / 5
Actionability	Provides concrete numbered checklists, verbatim message templates, and exact spec paths, but the visual-companion sub-flow is only partially actionable because the referenced visual-companion.md is absent and the provided scripts/ bundle is never referenced by name from the body.	4 / 5
Workflow Clarity	Three numbered path checklists with explicit approval checkpoints at every terminus, plus feedback loops (spec self-check fix loop, user-review re-run loop, and the path-upgrade ratchet) — matches the anchor for clear sequence with explicit validation and error-recovery loops.	5 / 5
Progressive Disclosure	Section structure is good and one reference is signaled one level deep ("在继续之前阅读详细指南：skills/brainstorming/visual-companion.md"), but that referenced file is absent and the five provided bundle scripts (server.cjs, helper.js, start-server.sh, stop-server.sh, frame-template.html) are never referenced from the body, leaving them orphaned.	3 / 5
	Total	15 / 20 Passed

Description

83%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 description that clearly states both the capability and the before-creative-work trigger with concrete enumerated scenarios. It is mostly distinct from sibling skills with only minor overlap risk.

Dimension	Reasoning	Score
Specificity	Enumerates several concrete trigger situations ("创建功能、构建组件、添加功能或修改行为"), and the capability ("探索用户意图、需求和设计") is named concretely with only minor abstraction in the deliverable actions.	4 / 5
Completeness	Explicitly answers both what (explore intent, requirements, design before implementation) and when ("在任何创造性工作之前必须使用" plus enumerated concrete triggers), matching the anchor for clear what+when with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good coverage of natural phrases users say (创建功能/构建组件/添加功能/修改行为), with a few synonyms (新项目/重构) absent — fits the 'good keyword coverage, a few terms missing' anchor.	4 / 5
Distinctiveness Conflict Risk	Carves a clear pre-implementation design niche, but has minor overlap risk with closely related planning/design skills such as writing-plans.	4 / 5
	Total	17 / 20 Passed

Validation

81%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: 79ea5d2

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.