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

69

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a tight, well-structured instruction skill with a clearly sequenced multi-phase workflow, explicit validation checkpoints, and concrete actionable guidance. It needs no bundle files and stays appropriately concise.

DimensionReasoningScore

Conciseness

The body is a lean bullet structure with no concept-explanation padding, assuming Claude's competence; every line earns its place and nothing restates what Claude already knows.

3 / 3

Actionability

It gives concrete, executable guidance with specific quantities ('ONE question at a time', '2-3 different approaches', '200-300 word sections') and copy-ready phrasing, which is appropriately actionable for an instruction-only skill.

3 / 3

Workflow Clarity

A clear five-phase sequence with explicit validation checkpoints ('Does this look right so far?', 'When your human partner confirms') and a 'When to Revisit Earlier Phases' feedback loop for error recovery.

3 / 3

Progressive Disclosure

No bundle files are needed; the skill is well-organized into single-file sections with clearly signaled one-level pointers to sibling skills (using-git-worktrees, writing-plans), appropriate for its scope.

3 / 3

Total

12

/

12

Passed

Description

67%

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 conveys purpose and includes an explicit trigger, but it uses directive second-person voice and a very broad trigger phrase that weakens specificity and distinctiveness. Trigger terms also miss common user phrasings like 'brainstorm'.

Suggestions

Rewrite in third person (e.g. 'Refines rough ideas into fully-formed designs...') and move the trigger into a 'Use when...' clause to avoid the second-person specificity penalty.

Add natural trigger terms users would actually say — 'brainstorm', 'design an idea', 'refine an idea' — alongside the existing phrases.

Narrow the trigger to reduce conflict risk, e.g. 'Use when refining a rough idea into a design before writing code or an implementation plan', to distinguish it from generic coding/planning skills.

DimensionReasoningScore

Specificity

It lists concrete methods ('structured Socratic questioning, alternative exploration, and incremental validation'), but the imperative 'IMMEDIATELY USE THIS SKILL' is second-person voice, which the guidelines penalize by one point, capping it at 2 rather than 3.

2 / 3

Completeness

It states both what it does ('refines rough ideas into fully-formed designs through...') and an explicit when-trigger ('USE THIS SKILL when creating or develop anything and before writing code or implementation plans'), so it is not capped at 2.

3 / 3

Trigger Term Quality

Some natural triggers appear ('rough ideas', 'before writing code or implementation plans'), but common variations like 'brainstorm' or 'design' are absent and 'Socratic questioning' is jargon users would not naturally say.

2 / 3

Distinctiveness Conflict Risk

The trigger 'creating or develop anything and before writing code or implementation plans' is broad and overlaps with planning/coding skills (the body itself references a writing-plans skill), so it could trigger for the wrong skill.

2 / 3

Total

9

/

12

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.

Validation16 / 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.