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
66%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-spark/skills/arn-brainstorming/SKILL.mdQuality
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').
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |
1fe948f
Table of Contents
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.