CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.

77

1.12x
Quality

75%

Does it follow best practices?

Impact

89%

1.12x

Average score across 3 eval scenarios

SecuritybySnyk

—

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./data/01-productmanager-brainstorming/SKILL.md

The canonical home for this skill is brainstorming in majiayu000/claude-skill-registry

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a well-structured, actionable process guide with clear sequencing and built-in validation checkpoints, appropriately self-contained for its size. Its main weakness is redundancy — the Key Principles section duplicates guidance already stated in The Process — and it lacks concrete examples of the dialogue or output artifacts it prescribes.

Suggestions

Remove or drastically trim the 'Key Principles' section, since each bullet restates a rule already covered in 'The Process', saving tokens without losing guidance.

Add one example multiple-choice follow-up question and a brief outline of the design document structure to make the dialogue and output formats copy-paste concrete.

Clarify where 'Documenting & Specifying' fits in the sequence, or move it under 'After the Design' where the PRD/feature docs are actually produced.

DimensionReasoningScore

Conciseness

The body is mostly lean bullet-point guidance with no concept explanations, but the entire 'Key Principles' section restates rules already given in 'The Process' ('One question at a time', 'Multiple choice preferred', 'Explore alternatives... 2-3 approaches', 'Incremental validation'), which is more than minor trimming. This fits 'mostly efficient but could be tightened' rather than the minor-instances anchor at 4.

3 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: 'sections of 200-300 words', the path template 'docs/plans/YYYY-MM-DD-<topic>-design.md', the exact question 'Ready to set up for implementation?', and 'Propose 2-3 different approaches with trade-offs'. It stops short of fully copy-paste-ready because there is no example follow-up question or design-document skeleton to cover common cases.

4 / 5

Workflow Clarity

The process is clearly sequenced (understand the idea → explore approaches → present the design → document → implement) with explicit checkpoints ('Ask after each section whether it looks right so far', 'Be ready to go back and clarify'). Minor gaps remain: the 'Documenting & Specifying' section's placement in the flow is ambiguous, and the criterion for when to stop asking questions is only implicit in 'Once you understand what you're building'.

4 / 5

Progressive Disclosure

This is a small (~55-line) self-contained process skill with clean section headers and no content bulky enough to offload to separate files; no bundle files exist, so nothing is misplaced. External skill references ('mcp-feedback-enhanced', 'superpowers:writing-plans', 'elements-of-style') are clearly signaled and conditional, warranting the top anchor under the simple-skill guideline.

5 / 5

Total

16

/

20

Passed

Description

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

The description excels at explicitly stating when to use the skill with concrete trigger phrases, but its capability description is thin and abstract, and the sweeping 'before any creative work' scope with mandatory framing creates high conflict risk with other development skills. The second-person 'You MUST' phrasing further costs it specificity under the rubric.

Suggestions

Rewrite in third person and lead with concrete capabilities, e.g. 'Explores user intent, requirements, and design alternatives through one-question-at-a-time dialogue before implementation, producing validated design documents.'

Narrow the trigger scope to the design/planning phase (e.g. 'Use when the user wants to design or plan a new feature before implementation') to reduce conflict with execution-focused skills.

Add natural synonyms such as 'brainstorm', 'plan a feature', or 'explore requirements' to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The capability statement is a single abstract action ('Explores user intent, requirements and design before implementation') while the enumerated list ('creating features, building components, adding functionality, or modifying behavior') describes trigger contexts, not what the skill does — matching the anchor for minimal/generic actions. The rubric's second-person penalty ('You MUST use this') reduces the base of 3 by 1.

2 / 5

Completeness

It explicitly answers both: what ('Explores user intent, requirements and design before implementation') and when ('You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior') with concrete trigger phrases. The when-clause is already explicit and specific, so it fits the top anchor rather than the 'could be more explicit' anchor at 4.

5 / 5

Trigger Term Quality

Natural user phrases like 'creating features', 'building components', 'adding functionality', and 'modifying behavior' give good coverage, but common synonyms such as 'brainstorm', 'implement', or 'plan a feature' are missing, so it falls short of the comprehensive anchor.

4 / 5

Distinctiveness Conflict Risk

The trigger scope ('before any creative work... or modifying behavior') sweeps in nearly every development task and the 'MUST' framing claims precedence over other skills, creating high overlap risk with many implementation-related skills. It is not a 1 because the design/brainstorming niche itself is distinct from execution skills.

2 / 5

Total

13

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

majiayu000/claude-skill-registry-data

Path

data/01-productmanager-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.