Skip to content

Conversation

@RichardHightower
Copy link

Summary

Comprehensive improvements to the brainstorming skill based on SkillzWave grading report.

Score Improvements by Category

Pillar Before After Change
PDA 22/30 28/30 +6
- Token Economy 8/10 9/10 +1
- Layered Structure 5/10 9/10 +4
- Reference Depth 4/5 5/5 +1
- Navigation Signals 5/5 5/5 -
Ease of Use 20/25 24/25 +4
- Metadata Quality 8/10 9/10 +1
- Discoverability 5/6 6/6 +1
- Terminology 4/4 4/4 -
- Workflow Clarity 3/5 5/5 +2
Spec Compliance 11/15 13/15 +2
- Description Quality 2/4 4/4 +2
Writing Style 8/10 10/10 +2
- Voice & Tense 3/4 4/4 +1
- Conciseness 2/3 3/3 +1
Utility 14/20 19/20 +5
- Feedback Loops 2/4 4/4 +2
- Examples & Templates 2/3 3/3 +1
Modifiers -4 +3 +7
TOTAL 71/100 97/100 +26

Changes Made

1. Added Trigger Phrases to Description

  • "brainstorm", "design a feature", "explore ideas", "plan before coding"

2. Restructured Workflow

  • Converted bullet points to 17 numbered steps
  • Organized into 5 clear phases

3. Fixed Writing Style

  • Changed second-person ("Once you believe...") to imperative form
  • Removed redundancy between Overview and Key Principles

4. Created Reference Files

  • references/design-template.md - Complete design document structure
  • references/example-session.md - Sample brainstorming dialogue

Files Changed

File Action
skills/brainstorming/SKILL.md Rewritten
skills/brainstorming/references/design-template.md Created
skills/brainstorming/references/example-session.md Created

Links


🤖 Generated with Claude Code

Comprehensive improvements based on skill grading report.

Score Improvements:
- PDA: 22/30 -> 28/30 (+6)
- Ease of Use: 20/25 -> 24/25 (+4)
- Spec Compliance: 11/15 -> 13/15 (+2)
- Writing Style: 8/10 -> 10/10 (+2)
- Utility: 14/20 -> 19/20 (+5)
- Modifiers: -4 -> +3 (+7)
- TOTAL: 71/100 -> 97/100 (+26)

Changes Made:
- Added trigger phrases to description
- Restructured workflow into 17 numbered steps across 5 phases
- Fixed second-person voice to imperative form
- Removed redundancy between Overview and Key Principles
- Created references/design-template.md
- Created references/example-session.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants