CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brainstorm

Turn an idea into a Conventional Docs Decision, then a Plan: classify the request, explore options and risks through dialogue, then commit a numbered Decision that review, prototypes, and acceptance move through. Use PROACTIVELY before any creative work — new features, new subsystems, interface or dependency changes, or any open-ended design question ("what are the options", "how should I approach", "should I use X or Y", "help me decide", "write a decision", "ADR").

Quality

77%

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

Quality

Content

55%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 maximally lean delegation shim: one unambiguous instruction pointing to a shared skill file outside the bundle. As a standalone SKILL.md it provides no workflow, no actionable guidance, and no bundled material, and the referenced path is environment-dependent rather than part of the skill. Its only strength is extreme token efficiency.

Suggestions

Bundle the shared skill content (or a distilled version of it) under references/ and reference it with a relative path, making the skill self-contained and the pointer verifiable within the bundle (addresses progressive_disclosure).

Inline a minimal outline of the core workflow — classify the request, explore options and risks through dialogue, commit a numbered Decision, produce a Plan — so the body shows a visible sequence with its key checkpoints (addresses workflow_clarity).

Add a one-to-two line overview of the skill's artifacts (the numbered Decision and the Plan) and how review, prototypes, and acceptance consume them, so the load instruction is supplemented by concrete standalone guidance (addresses actionability).

DimensionReasoningScore

Conciseness

The body is two lines — a generator comment and one instruction — with zero padding or over-explanation; every token earns its place. Matches the anchor-5 'lean and efficient' example; anchor 4 would require minor over-explanation to trim, and none is present.

5 / 5

Actionability

'Load and follow the shared skill at ~/.agents/skills/brainstorm/SKILL.md' is a concrete, executable instruction with a specific path, but it is the entire guidance — all actual task content lives in a file outside the bundle. This is a missing-key-details situation (anchor 3), not the minor gaps of anchor 4, since the skill itself carries no actionable content.

3 / 5

Workflow Clarity

The skill's own multi-step process (classify the request, explore options and risks, commit a numbered Decision, then a Plan) has no sequence, checkpoints, or validation steps anywhere in the body — only a delegation pointer. The clean, unambiguous delegation keeps it above the incoherent anchor 1, but no steps are listed, so it falls below anchor 3.

2 / 5

Progressive Disclosure

The single reference is clearly signaled and one level deep, but it points outside the skill bundle to ~/.agents/skills/brainstorm/SKILL.md (no references/, scripts/, or assets/ exist, and the path does not resolve in this environment), so the skill carries no content of its own and the pointer is unverifiable. Minimal structure with a non-bundled, environment-dependent dependency sits below anchor 3's 'could be better organized'.

2 / 5

Total

12

/

20

Passed

Description

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

A strong description: it explicitly states both what the skill does and when to use it, backed by a comprehensive list of natural trigger phrases in third-person imperative voice. Minor deductions for unexplained jargon ('Conventional Docs Decision') and broad proactive triggers that could overlap with general planning skills.

DimensionReasoningScore

Specificity

Lists several specific actions — 'classify the request', 'explore options and risks through dialogue', 'commit a numbered Decision' — matching anchor 4's 'several specific actions; minor gaps'. Not anchor 5 because 'Conventional Docs Decision' is unexplained jargon and the downstream stages ('review, prototypes, and acceptance move through') are gestured at rather than specified; above anchor 3 because more than 1–2 concrete actions are named.

4 / 5

Completeness

Explicitly answers both what ('classify the request, explore options and risks through dialogue, then commit a numbered Decision that review, prototypes, and acceptance move through') and when ('Use PROACTIVELY before any creative work — new features, new subsystems, interface or dependency changes, or any open-ended design question') with concrete quoted trigger phrases. This matches the anchor-5 pattern exactly; anchor 4 would require the 'when' clause to be less explicit.

5 / 5

Trigger Term Quality

Provides comprehensive natural-phrase coverage: 'what are the options', 'how should I approach', 'should I use X or Y', 'help me decide', 'write a decision', 'ADR', plus proactive triggers like 'new features' and 'interface or dependency changes'. These are exactly the phrases a user would say when needing this skill; anchor 4 would require missing natural terms or synonyms, and none are missing for this domain.

5 / 5

Distinctiveness Conflict Risk

The decision-record framing ('numbered Decision', 'write a decision', 'ADR') establishes a clear niche with distinct triggers, but 'before any creative work' and 'how should I approach' are broad enough to overlap with general planning or architecture skills. Mostly distinct with minor overlap risk against closely related skills (anchor 4) rather than the minimal conflict risk of anchor 5.

4 / 5

Total

18

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.claude/skills/brainstorm/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.