Use before creative or constructive work (features, architecture, behavior). Transforms vague ideas into validated designs through disciplined reasoning and collaboration.
45
47%
Does it follow best practices?
Impact
—
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 a clear domain. While it attempts to provide trigger guidance with 'Use before creative or constructive work', the scope is so broad it would conflict with many other skills. It reads more like a marketing tagline than a functional skill selector.
Suggestions
List specific concrete actions the skill performs, e.g., 'Generates design documents, evaluates trade-offs, creates architecture diagrams, writes feature specifications'.
Narrow the scope and add distinct trigger terms users would naturally say, e.g., 'Use when the user asks for a design doc, RFC, technical spec, system design, or wants to plan a new feature before implementation'.
Replace vague phrases like 'disciplined reasoning and collaboration' and 'validated designs' with concrete outputs or deliverables 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. It does have an explicit 'Use when' equivalent, so it's not capped at 1, but the overall guidance is weak. | 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 'features', 'architecture', 'creative or constructive work', and 'validated designs' are extremely broad and would overlap with many skills—coding skills, architecture skills, planning skills, brainstorming skills, etc. There is no clear niche that distinguishes this from other design or planning related skills. | 1 / 3 |
Total | 6 / 12 Passed |
Implementation
62%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 process skill with excellent workflow clarity, featuring hard gates, validation checkpoints, and clear exit criteria. Its main weaknesses are the lack of concrete examples (what does a good decision log entry or understanding summary look like?) and some verbosity in restating constraints. The skill would benefit from example artifacts and better progressive disclosure through supporting files.
Suggestions
Add concrete examples of key artifacts: a sample Understanding Summary (5-7 bullets), a Decision Log entry, and a design section—this would significantly boost actionability.
Extract templates (Decision Log format, Understanding Summary template, Documentation output format) into separate referenced files to improve progressive disclosure and reduce the main file's length.
Remove redundant constraint statements—the 'no implementation' rule is stated in Purpose, Operating Mode, and Exit Criteria; consolidate to one authoritative location.
Link the referenced 'multi-agent-brainstorming' skill explicitly with a file path or clear pointer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably structured but includes some unnecessary verbosity—repeated emphasis on constraints Claude could infer (e.g., 'You are not allowed to implement'), boilerplate sections like 'When to Use' and 'Limitations' that add little value, and some redundancy between 'Key Principles' and rules stated earlier in the process steps. | 2 / 3 |
Actionability | The skill provides a clear multi-step process with specific prompts to use (e.g., the confirmation question in step 4), but it remains largely instructional/procedural without concrete examples of what a good understanding summary, decision log entry, or design section actually looks like. Adding example outputs would significantly improve actionability. | 2 / 3 |
Workflow Clarity | The workflow is exceptionally well-sequenced with numbered steps, hard gates (Understanding Lock), explicit validation checkpoints ('Does this accurately reflect your intent?', 'Does this look right so far?'), clear exit criteria, and feedback loops (continue refinement if criteria unmet). This is a strong example of workflow clarity for a non-code process. | 3 / 3 |
Progressive Disclosure | The content is well-organized with clear headers and sections, but it's a monolithic document (~200 lines) with no references to supporting files. The Decision Log template, example outputs, and documentation templates could be split into separate reference files. The reference to 'multi-agent-brainstorming' skill is mentioned but not linked. | 2 / 3 |
Total | 9 / 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 | |
fb2efea
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.