Skip to content

Trim /setup skill from 475 to under 400 lines by removing redundant content #111

Description

@sebastientaggart

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

Metadata

Metadata

Labels

choreRoutine maintenanceqa-passedQA completed, passes

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions