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.

71

Quality

88%

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

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is highly actionable with a clearly sequenced, gated workflow and concrete commands/templates. Its main weaknesses are redundancy across sections and progressive-disclosure gaps where referenced files (workflow.md, task.py) are not bundled and large templates are inlined.

Suggestions

Dedupe repeated guidance: state 'one question per message', 'action before asking', and 'research-first' once in Core Principles and have later steps reference them instead of restating them.

Bundle the referenced files (workflow.md, the .trellis/scripts/task.py helpers) in references/ or scripts/ so the 'see workflow.md Phase 1.2' and task.py commands resolve to real files, or remove the references.

Move the large PRD template and research/expansion output templates into a referenced file (e.g. references/prd-template.md) and keep SKILL.md as an overview that points to it.

DimensionReasoningScore

Conciseness

The body is useful but repetitive — 'one question per message', 'action before asking', and 'research-first' are restated across the CoreRule, Core Principles, Step 3 Gate, Step 4, and Anti-Patterns, so it could be tightened; it does not explain concepts Claude doesn't know, so it is not a 1.

2 / 3

Actionability

Provides concrete executable commands (e.g. 'python3 ./.trellis/scripts/task.py create ...') and complete copy-paste-ready markdown templates for the PRD, research, expansion, and final confirmation, matching the fully-executable anchor.

3 / 3

Workflow Clarity

Steps 0–8 are clearly sequenced with explicit gates (Gate A/B/C, complexity table) and an explicit final-confirmation checkpoint; the convergence/approval loop serves as the validation checkpoint for this interview-style workflow.

3 / 3

Progressive Disclosure

The body references external files that are not present in any bundle — 'workflow.md' (Phase 1.2) and '.trellis/scripts/task.py' — and large PRD/research templates are inlined rather than split into referenced files, so structure exists but references are unresolved and organization could be improved.

2 / 3

Total

10

/

12

Passed

Description

100%

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 strong: it enumerates concrete capabilities, includes natural trigger terms, and explicitly covers both what and when. It occupies a clear niche with low conflict risk.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Creates task directory, seeds PRD, asks high-value questions one at a time, researches technical choices, and converges on MVP scope' — which matches the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

Clearly answers both what (the enumerated actions) and when via an explicit 'Use when ...' clause, matching the anchor that requires explicit triggers for both.

3 / 3

Trigger Term Quality

Includes natural user phrases such as 'requirements are unclear', 'multiple valid approaches', and 'user describes a new feature or complex task', giving good coverage of terms a user would naturally say.

3 / 3

Distinctiveness Conflict Risk

The collaborative requirements-discovery / brainstorm-before-implementation niche is distinct from execution skills, and its triggers are specific enough to avoid firing for unrelated skills.

3 / 3

Total

12

/

12

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (549 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 2 missing

Warning

Total

14

/

16

Passed

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.