CtrlK
BlogDocsLog inGet started
Tessl Logo

brainstorming

IMMEDIATELY USE THIS SKILL when creating or develop anything and before writing code or implementation plans - refines rough ideas into fully-formed designs through structured Socratic questioning, alternative exploration, and incremental validation

60

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agency/plugins/nori/skills/brainstorming/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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, concise instruction-only skill: a clear five-phase process with explicit validation checkpoints, backward-recovery feedback loops, and concrete question scripts. Its only real weaknesses are minor duplication between the phase rules and the 'Remember' checklist, and a few high-level steps.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence with terse bullets, but the 'Remember' section restates rules already given in the phases ('One question per message during Phase 1', 'Explore 2-3 alternatives before settling'), which is minor trimmable duplication.

4 / 5

Actionability

Guidance is concrete and executable for a conversational skill — 'Ask ONE question at a time', 'Propose 2-3 different approaches', 'Present in 200-300 word sections', literal question scripts ('Does this look right so far?') — with only minor high-level spots like 'Check current project state in working directory'.

4 / 5

Workflow Clarity

Five phases are clearly sequenced with explicit validation checkpoints ('Ask after each section: "Does this look right so far?"', confirmation before planning handoff), a dedicated feedback loop section ('When to Revisit Earlier Phases'), and a closing checklist — matching the top anchor. The skill is conversational, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

There are no bundle files and nothing inlined that belongs elsewhere; the ~70-line body is well organized into clean sections, and the cross-skill references (.claude/skills/using-git-worktrees, writing-plans) are one level deep and clearly signaled at the point of use.

5 / 5

Total

18

/

20

Passed

Description

55%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 clearly states what the skill does and includes an explicit 'when' clause, but its trigger is unboundedly broad ('creating or develop anything') and it omits the natural keyword 'brainstorm' that users would most likely say. Distinctiveness suffers from the catch-all scope, which invites conflicts with planning and implementation skills.

Suggestions

Narrow the trigger clause from 'when creating or develop anything' to specific situations, e.g. 'Use when the user has a rough idea, wants to brainstorm or refine requirements, or asks to explore approaches before implementation'.

Add the natural trigger terms users actually say — 'brainstorm', 'flesh out this idea', 'explore options', 'design' — to improve keyword coverage and routing accuracy.

Fix the grammar of the trigger ('when creating or develop anything' → 'when creating or developing anything') and state the handoff boundary (e.g. 'stops before writing code; hands off to planning skills') to reduce overlap with implementation skills.

DimensionReasoningScore

Specificity

Names the domain ('refines rough ideas into fully-formed designs') and three methods ('structured Socratic questioning, alternative exploration, and incremental validation'), but these are process abstractions rather than concrete operations with clear outputs, matching 'names domain and 1-2 concrete actions, but not comprehensive' better than the anchor above.

3 / 5

Completeness

Both parts are explicit — what ('refines rough ideas into fully-formed designs through...') and when ('when creating or develop anything and before writing code or implementation plans') — but the 'when' is overly broad and could be more specific, so it does not reach the concrete-trigger clarity of a 5.

4 / 5

Trigger Term Quality

Some relevant phrases ('refine', 'implementation plans', 'writing code') are present, but the most natural user term 'brainstorm' and common synonyms ('flesh out an idea', 'explore options') are missing, so keyword coverage has clear gaps.

3 / 5

Distinctiveness Conflict Risk

The trigger 'when creating or develop anything and before writing code' claims applicability to virtually all development work, creating high overlap risk with planning, coding, and design skills, even though the 'what' describes a distinct niche.

2 / 5

Total

12

/

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
microsoft/FluidFramework
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.