CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brainstorm

Collaborative requirements discovery session optimized for AI coding workflows. Creates task directories, seeds PRDs, runs codebase research, proposes concrete implementation approaches with trade-offs, and converges on MVP scope through structured Q&A. Use when requirements are unclear, multiple implementation paths exist, trade-offs need evaluation, or a complex feature needs scoping before development.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-sequenced, highly actionable process skill with explicit gates, templates, and a clear complexity-routing table, but it pays for it in token budget: significant template and rule duplication across sections, and no progressive disclosure — everything lives inline in one long file. Consolidating duplicated blocks and moving templates to a references file would raise both weak dimensions.

Suggestions

Deduplicate templates: keep one canonical PRD template (merge Step 0's seed template with 'PRD Target Structure (final)') and one Approach A/B/C proposal format (merge Step 4's research output with Step 7's proposal template), referencing them instead of restating.

Move the large template blocks (PRD seed/final templates, research output format, expansion and confirmation message templates) into a references/ file such as references/templates.md so SKILL.md stays a lean overview that loads fewer tokens on every invocation.

Consolidate the rule statements: Core Principles, the Step 3 question gates, and the Anti-Patterns section all restate 'action before asking', 'one question per message', and 'concrete options with trade-offs' — state each rule once where it is enforced.

DimensionReasoningScore

Conciseness

The body is all actionable guidance with no explanations of concepts Claude already knows, but it is noticeably repetitive: the PRD template appears twice (Step 0 seed template and "PRD Target Structure (final)"), the Approach A/B/C pros/cons format appears in both Step 4 and Step 7, and the same rules are stated three times (Core Principles, Steps 3–6, and Anti-Patterns). It is not 2 because the padding is rule repetition rather than fluff or filler explanation, and not 4 because deduplicating would cut roughly a quarter of the file.

3 / 5

Actionability

Provides executable commands ("python3 ./.trellis/scripts/task.py create 'brainstorm: <short goal>' --slug <auto>", "--parent", "add-subtask") plus complete copy-paste markdown templates for the PRD, research notes, expansion message, preference questions, and final confirmation. It is not 5 because commands as written are not fully copy-paste runnable ("--slug <auto>" is an unresolved placeholder), and not 3 because the templates are complete rather than pseudocode.

4 / 5

Workflow Clarity

Steps 0–8 are clearly sequenced with explicit checkpoints: question Gates A–C before asking anything, PRD updates after each answer, and a final confirmation gate ("Does this look correct? If yes, I'll proceed with implementation"). It is not 5 because there is no explicit error-recovery branch (e.g. what to do when the user rejects the final confirmation or research dead-ends), and not 3 because checkpoints are explicit and abundant rather than implicit. This is a conversational skill, so the destructive/batch cap does not apply.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the ~490-line SKILL.md inlines large template blocks (PRD seed template, research output format, message templates) that belong in a references/ file. Section structure is clean with per-step headers, so it is not 2, but it is not 4 because most of the template content is inlined rather than split out, and the under-50-line exception clearly does not apply at this length.

3 / 5

Total

14

/

20

Passed

Description

88%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: third-person voice, comprehensive concrete action list, and an explicit 'Use when...' clause with realistic trigger conditions. The only weaknesses are missing natural synonyms (e.g. 'brainstorm', 'explore options') and minor overlap risk with general planning/decision skills. Scores are strong enough that no suggestions are needed.

DimensionReasoningScore

Specificity

"Creates task directories, seeds PRDs, runs codebase research, proposes concrete implementation approaches with trade-offs, and converges on MVP scope through structured Q&A" lists five concrete actions spanning the full workflow (capture → research → propose → converge), matching the anchor-5 'multiple specific concrete actions; comprehensive coverage' example. It is not 4 because there are no minor gaps — every phase of the skill's operation is named.

5 / 5

Completeness

Explicitly answers both: what ("Creates task directories, seeds PRDs, runs codebase research, proposes... approaches with trade-offs, and converges on MVP scope") and when ("Use when requirements are unclear, multiple implementation paths exist, trade-offs need evaluation, or a complex feature needs scoping before development"), with concrete trigger phrases — an exact match to the anchor-5 example. Not 4, since the 'when' clause is already fully explicit and specific.

5 / 5

Trigger Term Quality

"Use when requirements are unclear, multiple implementation paths exist, trade-offs need evaluation, or a complex feature needs scoping before development" contains several phrases users naturally say. It is not 3 (terms are natural and multiple, not generic) and not 5 because common synonyms are missing — e.g. "brainstorm", "explore options", "gather requirements".

4 / 5

Distinctiveness Conflict Risk

"Collaborative requirements discovery session... before development" carves a clear niche with mostly distinct triggers. It is not 5 because "trade-offs need evaluation" and "multiple implementation paths exist" could also trigger architecture/decision-making skills; it is not 3 because the pre-implementation scoping niche is far more specific than the anchor-3 'somewhat specific' example.

4 / 5

Total

18

/

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

202780181/lingxiData

Path

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