Problem to Fix
The /setup skill is 475 lines — the longest skill in the project — despite being a one-time configuration wizard. Much of the length comes from duplicated label baselines, verbose config walkthrough entries that repeat an identical pattern longhand for each value, a skills reference table that duplicates the README, and profile selection with redundant follow-up questions.
Why it Matters
Longer skills increase the chance of instruction-following errors and make maintenance harder. A one-time wizard doesn't need to carry the same weight as frequently-invoked workflow skills like /start or /submit-for-review.
General Approach
Trim setup.md from ~475 to ~375 lines by:
- Removing the skills reference table (already in README)
- Merging the greenfield label guidance into Phase 2's existing label population flow
- Defining the Phase 3 config walkthrough pattern once, then listing values as a compact table
- Factoring out shared profile selection questions
No behavioral changes — the setup wizard should do exactly the same things, just with less redundant instruction text.
Complexity
Verification / QA effort: moderate
Requires running /setup against projects in each state (State 1, State 2, State 3) to verify behavior is preserved after trimming.
Acceptance Criteria
- setup.md is under 400 lines
- All three states (just checking it out, partial setup, fully configured) produce the same behavior as before
- No setup wizard steps are removed or reordered
- Phase 2 label population and greenfield guidance are consolidated into a single flow
- Phase 3 config walkthrough uses a defined pattern rather than repeating longhand for each value
Problem to Fix
The
/setupskill is 475 lines — the longest skill in the project — despite being a one-time configuration wizard. Much of the length comes from duplicated label baselines, verbose config walkthrough entries that repeat an identical pattern longhand for each value, a skills reference table that duplicates the README, and profile selection with redundant follow-up questions.Why it Matters
Longer skills increase the chance of instruction-following errors and make maintenance harder. A one-time wizard doesn't need to carry the same weight as frequently-invoked workflow skills like
/startor/submit-for-review.General Approach
Trim setup.md from ~475 to ~375 lines by:
No behavioral changes — the setup wizard should do exactly the same things, just with less redundant instruction text.
Complexity
Verification / QA effort: moderate
Requires running
/setupagainst projects in each state (State 1, State 2, State 3) to verify behavior is preserved after trimming.Acceptance Criteria