Use before creative or constructive work (features, architecture, behavior). Transforms vague ideas into validated designs through disciplined reasoning and collaboration.
69
54%
Does it follow best practices?
Impact
93%
1.66xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/brainstorming/SKILL.mdQuality
Discovery
32%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 too abstract and buzzword-heavy ('disciplined reasoning', 'validated designs', 'collaboration') without specifying concrete actions or outputs. It lacks natural trigger terms users would actually say and is so broadly scoped that it would conflict with many other skills. The 'Use before...' framing is a good structural choice but the content within it is too vague to be useful for skill selection.
Suggestions
List specific concrete actions the skill performs, e.g., 'Generates design documents, evaluates trade-offs, defines API contracts, creates architecture diagrams'.
Add natural trigger terms users would say, e.g., 'Use when the user asks to design a system, write a design doc, plan a feature, create an RFC, or architect a solution'.
Narrow the scope to reduce conflict risk—clarify whether this is for software architecture, product design, feature planning, etc., rather than covering all 'creative or constructive work'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague, abstract language like 'creative or constructive work', 'vague ideas', and 'validated designs'. It does not list any concrete actions—'transforms' is the only verb and it's abstract. No specific capabilities like 'creates architecture diagrams', 'writes design docs', or 'generates feature specs' are mentioned. | 1 / 3 |
Completeness | It has a 'when' clause ('Use before creative or constructive work') and a vague 'what' ('Transforms vague ideas into validated designs through disciplined reasoning and collaboration'). However, the 'what' is too abstract to be truly informative, and the 'when' triggers are broad rather than explicit. The 'Use before...' structure partially satisfies the trigger guidance requirement. | 2 / 3 |
Trigger Term Quality | It includes some relevant keywords like 'features', 'architecture', and 'behavior' that users might mention, but these are broad and could apply to many contexts. Missing more natural trigger terms like 'design doc', 'spec', 'RFC', 'technical design', 'system design', 'plan', or 'proposal'. | 2 / 3 |
Distinctiveness Conflict Risk | Terms like 'creative or constructive work', 'features', 'architecture', and 'behavior' are extremely broad and would overlap with many skills—coding skills, architecture skills, product management skills, etc. There is no clear niche that distinguishes this from other design or planning skills. | 1 / 3 |
Total | 6 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted process-oriented skill with excellent workflow clarity and actionability. The hard gates, explicit confirmation prompts, and exit criteria make it highly effective for guiding Claude through a structured brainstorming process. Minor weaknesses include some redundancy between sections and the monolithic structure that could benefit from splitting templates or detailed guidance into separate files.
Suggestions
Remove redundancy between 'Operating Mode' and 'Key Principles' sections — consolidate into one concise set of constraints
Consider extracting the Decision Log format and Documentation template into separate reference files to improve progressive disclosure
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-structured but includes some redundancy (e.g., 'Operating Mode' section restates what's already in Purpose, and 'Key Principles' partially repeats rules from earlier sections). Some phrasing like 'Your job is to slow the process down just enough to get it right' is motivational rather than instructional. However, it avoids explaining concepts Claude already knows. | 2 / 3 |
Actionability | The skill provides highly specific, concrete guidance: exact question formats to use, hard gates with explicit confirmation prompts (quoted verbatim), specific section length targets (200-300 words), numbered steps with clear deliverables (5-7 bullet summary), and explicit exit criteria. While there's no code (appropriate for an instruction-only skill), every step is actionable and unambiguous. | 3 / 3 |
Workflow Clarity | The multi-step process is clearly sequenced with numbered phases, explicit hard gates (Understanding Lock at step 4, Exit Criteria at the end), validation checkpoints ('Does this accurately reflect your intent?', 'Does this look right so far?'), and feedback loops (continue refinement if criteria unmet). The workflow prevents premature progression with explicit stop conditions. | 3 / 3 |
Progressive Disclosure | The content is well-organized with clear headers and logical sections, but it's a monolithic document that could benefit from splitting detailed sections (e.g., Decision Log template, Documentation template) into separate reference files. The reference to 'multi-agent-brainstorming' skill at the end is a good cross-reference, but the main content is all inline at ~180 lines. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
d739c8b
Table of Contents
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.