CtrlK
BlogDocsLog inGet started
Tessl Logo

trellis-brainstorm

Guides collaborative requirements discovery before implementation. Creates task directory, seeds PRD, asks high-value questions one at a time, researches technical choices, and converges on MVP scope. Use when requirements are unclear, there are multiple valid approaches, or the user describes a new feature or complex task.

68

Quality

85%

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

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.

A well-structured governance/workflow skill: the planning flow is clearly sequenced with explicit validation gates, feedback loops, and stop conditions, and the guidance is largely concrete and project-specific. The main weaknesses are redundant restatement of the approval and evidence rules across sections, a generic first-principles section that could be condensed or split out, and an undefined complex-vs-lightweight task boundary.

Suggestions

Consolidate the approval-gate and evidence rules into a single authoritative statement and reference it from the other sections instead of restating them in the Planning Contract, Planning Flow, Question Rules, and Quality Bar.

Move or trim the generic First Principles Analysis section — its tables and challenge prompts are methodology Claude already knows; keep only the project-specific instruction on when to apply it.

Define the complex-vs-lightweight task distinction explicitly (e.g., criteria for when design.md and implement.md are required) since it gates step 6 of the Planning Flow.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows about its own tooling and is dense with project-specific rules, but the approval gate, evidence rule, and PRD-convergence requirements are each restated across three to four sections (e.g., approval appears in the Planning Contract, Planning Flow steps 8-9, Question Rules, and Quality Bar). The ~40-line generic First Principles framework ("Network latency ≥ 0", "Data must be consistent") also teaches methodology Claude already knows. It is not 2 because most tokens convey non-obvious project rules; it is not 4 because the repetition and generic framework are clearly trimmable.

3 / 5

Actionability

Concrete guidance throughout: an executable `task.py create` command with flag semantics and failure behavior ("create rejects blanks"), an enumerated question structure (decision needed, why it matters, recommended answer, trade-off), explicit artifact contents, and a final-summary element list. It is not 5 because the complex-vs-lightweight task boundary that gates design.md/implement.md is never crisply defined, and there is no worked example of a good question or final planning summary.

4 / 5

Workflow Clarity

The 9-step Planning Flow has an explicit sequence with validation checkpoints (requirement convergence gate, PRD convergence pass, Quality Bar checklist) and feedback loops ("After each user answer, update prd.md, recompute the decision inventory, and repeat from step 2"; "If the artifacts change materially after approval, repeat the final review"). Stop conditions are explicit ("Do not run task.py start or edit product code in the same turn"). It is not 4 because every phase transition has an explicit gate and no validation checkpoint is missing.

5 / 5

Progressive Disclosure

The body is well-sectioned with clear, navigable headers and all content is procedural to this skill's execution; no bundle files exist and none are strictly required. It is not 5 because the ~40-line generic First Principles framework is not specific to this workflow and is a natural candidate for a separate reference file, making the single file longer than an overview needs to be; it is not 3 because there is no bulk reference material inlined and the structure is consistent.

4 / 5

Total

16

/

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: it names the domain, enumerates concrete capabilities, and includes an explicit 'Use when' clause with natural trigger conditions. The only weaknesses are a few missing synonyms (planning, brainstorm, spec) and minor overlap risk with general planning skills.

Suggestions

Add natural trigger synonyms such as 'planning', 'brainstorming', or 'writing a spec/PRD' to the 'Use when' clause to broaden natural-language matching.

Mention the design.md/implement.md planning artifacts among the capabilities to further distinguish the skill from generic planning or spec-writing skills.

DimensionReasoningScore

Specificity

The description lists five concrete actions — "Creates task directory, seeds PRD, asks high-value questions one at a time, researches technical choices, and converges on MVP scope" — giving comprehensive coverage of the requirements-discovery workflow. It is not 4 because the action list covers the full discovery-to-scope pipeline rather than leaving gaps.

5 / 5

Completeness

It explicitly answers both "what" (the concrete action list) and "when" ("Use when requirements are unclear, there are multiple valid approaches, or the user describes a new feature or complex task") with concrete trigger phrases. It is not 4 because the when-clause is explicit and specific, not merely present.

5 / 5

Trigger Term Quality

"requirements are unclear", "multiple valid approaches", "new feature", and "complex task" are natural phrases users would say, giving good keyword coverage. It is not 5 because common synonyms such as "planning", "brainstorm", "spec", or "requirements gathering" are missing.

4 / 5

Distinctiveness Conflict Risk

The task-directory/PRD/MVP-scope framing carves a distinct niche with triggers like "requirements are unclear" and "multiple valid approaches". It is not 5 because it could still overlap with generic planning, spec-writing, or architecture skills; it is not 3 because the PRD/task-directory artifacts anchor it to a specific workflow.

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
mindfold-ai/Trellis
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.