Use before creative or constructive work (features, architecture, behavior). Transforms vague ideas into validated designs through disciplined reasoning and collaboration.
63
54%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
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. While it attempts to provide a 'when' clause, the triggers are overly broad and would conflict with many other skills. The description reads more like a marketing tagline than a functional skill selector.
Suggestions
List specific concrete actions the skill performs, e.g., 'Generates design documents, creates architecture diagrams, writes feature specifications, and produces technical RFCs'.
Narrow the trigger terms to a distinct niche and add natural user phrases, e.g., 'Use when the user asks to design a feature, write a design doc, create a technical spec, or plan system architecture'.
Replace abstract language like 'disciplined reasoning and collaboration' with specific outputs or steps the skill produces.
| 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 useful, and the 'when' triggers are broad. The 'Use before...' phrasing partially satisfies the explicit 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-structured instruction-only skill with excellent workflow clarity and actionability—clear gates, validation checkpoints, and specific guidance at each step. Its main weaknesses are moderate verbosity (restating constraints, boilerplate sections) and a monolithic structure that could benefit from splitting detailed checklists and templates into referenced files. The reference to the 'multi-agent-brainstorming' skill lacks a proper link or path.
Suggestions
Trim the 'Operating Mode' section and merge its constraints into the 'Key Principles' section to reduce redundancy.
Extract the Decision Log format, non-functional requirements checklist, and documentation template into separate referenced files to improve progressive disclosure.
Provide a proper file path or link for the referenced 'multi-agent-brainstorming' skill.
Remove the generic 'When to Use' and 'Limitations' boilerplate sections—they restate what the skill already communicates.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably structured but includes some unnecessary verbosity—emoji headers, repeated emphasis on constraints Claude could infer, and boilerplate sections like 'When to Use' and 'Limitations' that add little value. The 'Operating Mode' section restates what the process already enforces. | 2 / 3 |
Actionability | The skill provides highly concrete, step-by-step guidance with specific prompts to use (quoted confirmation questions), exact formats (5-7 bullet summaries, 200-300 word sections), checklists, and clear decision criteria. While there's no code (appropriate for an instruction-only skill), every step is specific and executable. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced with numbered steps, explicit hard gates (Understanding Lock, Exit Criteria), validation checkpoints after each design section, and feedback loops ('confirm or correct before we move to design'). The exit criteria serve as a final validation checklist preventing premature progression. | 3 / 3 |
Progressive Disclosure | The content is well-organized with clear section headers and logical flow, but it's a monolithic document (~180 lines) with no references to supporting files. The Decision Log template, documentation format, and non-functional requirements checklist could be split into separate reference files. The reference to 'multi-agent-brainstorming' skill is mentioned but not linked. | 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 | |
9d0b37c
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.