CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-brainstorming

This skill should be used when the user says "brainstorming", "arn brainstorming", "brainstorm", "let's brainstorm", "start brainstorming", "brainstorming session", "greenfield wizard", "arn spark wizard", "greenfield pipeline", "walk me through greenfield", "guided greenfield", "full greenfield pipeline", "greenfield flow", "explore to feature backlog", "greenfield start to finish", "run the greenfield pipeline", "guide me through greenfield", "greenfield guided mode", "greenfield setup", "new project wizard", "add a feature", "new feature", "I need another feature", "add feature to greenfield", "one more feature", or wants to be walked through the entire Arness greenfield exploration pipeline in a single continuous session with guided decision gates instead of invoking each skill manually. Also triggers when the user wants to add a new feature to an existing greenfield project after the clickable prototype is complete.

71

Quality

66%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/arn-spark/skills/arn-brainstorming/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

54%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description is heavily skewed toward trigger terms at the expense of explaining what the skill actually does. While it excels at listing when to activate, it fails to describe the concrete actions performed — the user and Claude would not understand the skill's capabilities from this description alone. The description reads more like a keyword list than a functional specification.

Suggestions

Add concrete action descriptions explaining what the skill does, e.g., 'Guides users through the Arness greenfield exploration pipeline including project scoping, feature brainstorming, backlog creation, and clickable prototype generation.'

Restructure to lead with capabilities first, then consolidate trigger terms into a concise 'Use when...' clause rather than listing 25+ individual phrases.

Remove overly generic trigger terms like 'brainstorm', 'add a feature', and 'new feature' that could conflict with other skills, or qualify them with context (e.g., 'add a feature to a greenfield project').

DimensionReasoningScore

Specificity

The description is almost entirely trigger phrases with no concrete actions listed. It vaguely references 'the entire Arness greenfield exploration pipeline' and 'guided decision gates' but never explains what specific actions the skill performs (e.g., generating prototypes, creating backlogs, etc.).

1 / 3

Completeness

The 'when' is thoroughly covered with explicit trigger phrases and conditions. However, the 'what' is extremely weak — it only vaguely mentions being 'walked through the entire Arness greenfield exploration pipeline' and 'adding a new feature' without describing what the skill actually does in concrete terms.

2 / 3

Trigger Term Quality

The description provides extensive coverage of natural trigger phrases users would say, including variations like 'brainstorming', 'brainstorm', 'let's brainstorm', 'greenfield wizard', 'new project wizard', 'add a feature', 'new feature', etc. These are natural, conversational terms.

3 / 3

Distinctiveness Conflict Risk

The extensive list of specific trigger phrases like 'greenfield wizard', 'arn brainstorming', and 'greenfield pipeline' creates some distinctiveness. However, generic terms like 'brainstorm', 'add a feature', and 'new feature' could easily conflict with other skills, and the lack of concrete capability description makes it harder to distinguish from related skills.

2 / 3

Total

8

/

12

Passed

Implementation

77%

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

This is a well-structured orchestration skill with excellent actionability and workflow clarity — every step, gate, and error case is precisely specified with exact skill names, file paths, and user prompts. Its main weakness is length: the repeated progress bars, verbose stress test descriptions, and inline error handling catalog inflate token cost. The content would benefit from splitting reference material (artifact detection, error handling) into separate files to improve progressive disclosure.

Suggestions

Move the artifact detection table and error handling section into separate reference files (e.g., `references/artifact-detection.md` and `references/error-handling.md`) to reduce the main skill's token footprint and improve progressive disclosure.

Remove or significantly compress the repeated ASCII progress bars — define the format once and say 'Show progress bar with [CURRENT-STAGE] highlighted' at each step instead of repeating the full bar 12 times.

Trim the G-Stress stress test descriptions — Claude can read these from the sub-skill metadata or a reference file rather than having 4 multi-line descriptions inline in the wizard.

DimensionReasoningScore

Conciseness

The skill is lengthy but most content earns its place — the decision gate table, artifact detection table, and step sequences are necessary for a complex orchestration skill. However, the stress test explanations at G-Stress are verbose (Claude could summarize these from sub-skill metadata), and some error handling cases are over-explained. The progress bar ASCII art repeated 12+ times adds significant token cost.

2 / 3

Actionability

Highly actionable throughout: every gate specifies exact AskUserQuestion prompts with numbered options, every automated step names the exact skill to invoke with fully qualified names, artifact detection specifies exact file paths to check, and the decision logic is unambiguous with clear if/then branching for every option.

3 / 3

Workflow Clarity

Exceptional workflow clarity for a complex 12-step orchestration pipeline. Steps are clearly sequenced with explicit decision gates, the artifact detection table provides precise resumability logic ordered from most to least advanced, error handling covers edge cases with specific recovery actions (retry/skip/abort), and validation checkpoints are built into the gate structure (e.g., checking if prototype is locked before G5, checking issue tracker status at G6).

3 / 3

Progressive Disclosure

The skill references `add-feature-flow.md` for the Add Feature mode workflow (good delegation), and delegates all sub-skill logic to invoked skills. However, the main SKILL.md itself is a monolithic wall of text (~400+ lines) that could benefit from splitting the artifact detection table, error handling, and gate definitions into separate reference files. No bundle files were provided to verify the referenced path exists.

2 / 3

Total

10

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Repository
AppsVortex/arness
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.