CtrlK
BlogDocsLog inGet started
Tessl Logo

brainstorming

Devflow wrapper for the upstream brainstorming skill. Use when starting any creative work — creating features, building components, adding functionality, or modifying behavior — to explore user intent, requirements, and design before implementation. Always invoke `/devflow:brainstorming` rather than the upstream skill directly so devflow can layer in project-specific behavior (recall hooks, phase-handoff entry points) without callers ever needing to know about the upstream.

64

Quality

75%

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 ./devflow-plugin/skills/brainstorming/SKILL.md
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 clear, actionable instruction set for a thin delegation wrapper with a well-sequenced workflow and clean section structure. Its main weakness is redundancy around the writing-plans prohibition, which inflates the token budget without adding clarity.

Suggestions

Consolidate the 'do NOT invoke /writing-plans' guidance into one place — it currently appears in the step 3 prose, the surfaced message block, and the Important section.

Trim or fold the 'Why this wrapper exists' rationale into a single sentence; much of it is justification rather than instruction.

Make the upstream terminal-state detection condition in step 3 more concrete (e.g., a checklist of signals to look for) to reduce ambiguity in when to surface the handoff message.

DimensionReasoningScore

Conciseness

The body is mostly efficient but repeats the 'do NOT invoke /writing-plans' prohibition three times (step 3 prose, the code block, and the Important section) and includes a 'Why this wrapper exists' rationale section that could be trimmed.

3 / 5

Actionability

Provides concrete, executable guidance — an exact Skill-tool invocation with $ARGUMENTS passthrough, a copy-paste-ready handoff message block, and an exact fallback error string — with only minor gaps around detecting the upstream terminal state.

4 / 5

Workflow Clarity

The three steps are clearly sequenced and step 3 lists an explicit terminal-state checkpoint (design approved + spec written + spec approved) plus a fallback branch, though there is no formal error-recovery feedback loop.

4 / 5

Progressive Disclosure

A single-purpose wrapper under 50 lines with no need for external references and well-organized section headers (Steps, Why, Fallback, Important) — meets the simple-skill exception for a top score.

5 / 5

Total

16

/

20

Passed

Description

78%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 is well-constructed: it clearly states the wrapper's purpose and gives explicit, natural trigger guidance for when to use it. It is held back only by the inherent narrowness of a wrapper's action set and slightly broad trigger terms.

DimensionReasoningScore

Specificity

Names the domain ('Devflow wrapper for the upstream brainstorming skill') and concrete actions ('explore user intent, requirements, and design', 'invoke /devflow:brainstorming'), but as a thin wrapper its action set is inherently limited and not comprehensive.

3 / 5

Completeness

Explicitly answers both 'what' (wrapper that delegates to the upstream skill and overrides the terminal handoff) and 'when' ('Use when starting any creative work — creating features, building components, adding functionality, or modifying behavior') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes natural phrases users would say — 'creating features, building components, adding functionality, or modifying behavior' plus 'brainstorming' — giving good keyword coverage, though a few synonyms are absent.

4 / 5

Distinctiveness Conflict Risk

The devflow brainstorming wrapper is a clear niche with distinct slash-command triggers, but the broad trigger terms ('creating features', 'modifying behavior') carry minor overlap risk with closely related devflow or general coding skills.

4 / 5

Total

16

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
AndreJorgeLopes/devflow
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.