CtrlK
BlogDocsLog inGet started
Tessl Logo

brainstorming

Use before creative or constructive work (features, architecture, behavior). Transforms vague ideas into validated designs through disciplined reasoning and collaboration.

57

Quality

66%

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 ./skills/brainstorming/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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-sequenced facilitation workflow with strong validation gates and feedback loops, and its procedural guidance is concrete and actionable. Its main weakness is redundancy across sections that inflates length without adding information.

Suggestions

Merge the 'Operating Mode' prohibitions and the 'Key Principles' list into a single non-redundant section to remove restated rules and improve conciseness.

Consolidate the repeated YAGNI/one-question-at-a-time/explicit-assumptions directives so each principle appears once in the process where it is enforced.

Consider moving the detailed Decision Log and Documentation sections into a short reference file to keep SKILL.md a lean overview, improving progressive disclosure.

DimensionReasoningScore

Conciseness

The body is mostly efficient procedural guidance, but it restates rules across sections (Operating Mode's 'No creative implementation...' vs. Purpose's prohibitions; Key Principles re-lists 'One question at a time', 'Assumptions must be explicit', 'YAGNI ruthlessly' already covered in the process), so it could be tightened, matching 'mostly efficient but includes some unnecessary explanation'.

3 / 5

Actionability

As an instruction-only facilitation skill it gives concrete, executable directives ('Ask one question per message', 'Prefer multiple-choice questions', 'Propose 2–3 viable approaches', 'Break it into sections of 200–300 words max', 'Maintain a running Decision Log'), with only minor gaps, matching 'mostly executable guidance; concrete guidance with minor gaps'.

4 / 5

Workflow Clarity

The 7-step process is clearly sequenced with explicit hard-gate validation checkpoints (Understanding Lock requiring explicit confirmation, Exit Criteria hard-stop conditions) and a feedback loop ('If any criterion unmet: Continue refinement'), matching 'clear sequence with explicit validation steps; feedback loops for error recovery; checklists'.

5 / 5

Progressive Disclosure

No bundle files exist and the content is well-organized into clearly headed sections with no large reference material that should be split out; it is good single-file structure, though the ~230-line length exceeds the under-50-line simple-skill exception that would permit a 5, matching 'good structure; most content appropriately placed; minor organization gaps'.

4 / 5

Total

16

/

20

Passed

Description

58%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 answers both what the skill does and when to use it, with a reasonably distinct niche, but its actions are abstract and its trigger terms omit common user phrasings like 'brainstorm' or 'design'. It is solid but not comprehensive.

Suggestions

Add concrete actions the skill performs (e.g., 'asks clarifying questions one at a time, locks shared understanding, and proposes 2-3 design approaches with trade-offs') to lift specificity.

Include natural trigger terms users actually say ('brainstorm', 'design a feature', 'plan architecture', 'explore approaches') alongside 'creative or constructive work'.

Tighten the 'when' clause to explicit trigger phrases (e.g., 'Use when the user wants to design, brainstorm, or explore approaches before building') to reach a 5 on completeness.

DimensionReasoningScore

Specificity

It names the domain (creative/constructive design work) and a couple of actions ('Transforms vague ideas into validated designs', 'disciplined reasoning and collaboration'), but the actions are abstract rather than concrete operations, matching the 'names domain and 1-2 concrete actions but not comprehensive' anchor.

3 / 5

Completeness

Both 'what' ('Transforms vague ideas into validated designs through disciplined reasoning and collaboration') and 'when' ('Use before creative or constructive work (features, architecture, behavior)') are present; the when clause is explicit but could be more specific about trigger phrases, matching the 'has both what and when; when could be more explicit' anchor.

4 / 5

Trigger Term Quality

'creative or constructive work (features, architecture, behavior)' provides relevant natural triggers, but common variations users actually say ('brainstorm', 'design', 'plan', 'whiteboard') are missing, fitting 'some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

The pre-implementation design-facilitation niche is somewhat distinct, but the broad trigger 'creative or constructive work (features, architecture, behavior)' could overlap with general planning or design skills, fitting 'somewhat specific but could still overlap with similar skills'.

3 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
sickn33/antigravity-awesome-skills
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.