1---2name: github-labels3description: Set up structured GitHub issue labels for any repository. Installs curated label groups (priority, clarity, risk, blast radius, size, parallelism, sequencing, type, and special labels) using the GitHub CLI. Use this skill when a user mentions "set up labels", "github labels", "label taxonomy", or wants to organise their issue tracker.4---56## Prerequisites78- `gh` CLI installed and authenticated (`gh auth status` should succeed)9- Write access to the target repository1011## How it works12131. Detect or ask for the target repository (owner/repo format)142. Present available label groups and let the user pick153. Create each label via `gh label create` with `--force` (idempotent — safe to re-run)1617## Label Groups1819Present these groups to the user. Let them pick individually or say "all".2021### 1. Priority (`priority`)2223| Label | Color | Description |24|-------|-------|-------------|25| `P1` | `b60205` | Must ship first, blocks other work |26| `P2` | `d93f0b` | Core features, ship after P1 |27| `P3` | `e99695` | Polish and low-urgency items |28| `P4` | `f9d0c4` | Post-launch polish and enhancements |29| `P5` | `fef2c0` | Nice to have, no pressure |3031### 2. Clarity (`clarity`)3233| Label | Color | Description |34|-------|-------|-------------|35| `clarity:1` | `5319e7` | Vague idea — no spec, no definition of done, needs discussion |36| `clarity:2` | `7b61ff` | Problem defined, solution unclear — needs a design spike |37| `clarity:3` | `a78bfa` | Direction known, details TBD — can start with questions |38| `clarity:4` | `c4b5fd` | Clear spec, minor ambiguities — AI-shippable with light review |39| `clarity:5` | `ddd6fe` | Crystal clear, full definition of done — just execute |4041### 3. Risk (`risk`)4243| Label | Color | Description |44|-------|-------|-------------|45| `risk:1` | `0e8a16` | Isolated change, well-tested area, hard to break |46| `risk:2` | `53d353` | Small surface area, existing patterns, minor regression chance |47| `risk:3` | `fbca04` | Touches shared code, some edge cases, needs careful testing |48| `risk:4` | `e99695` | Cross-domain impact, state management, concurrency concerns |49| `risk:5` | `b60205` | Data model migration, navigation architecture, or seed data changes |5051### 4. Blast Radius (`blast`)5253| Label | Color | Description |54|-------|-------|-------------|55| `blast:1` | `bfdadc` | Single file — one view or one service, no ripple effects |56| `blast:2` | `7ec8cb` | Single domain — 2-5 files within one feature folder |57| `blast:3` | `3bb3b8` | Cross-domain — touches shared code or 2+ feature domains |58| `blast:4` | `1d7a7e` | Architectural — services, navigation, data flow changes |59| `blast:5` | `0e4f52` | Full-stack — data pipeline + app, or schema changes |6061### 5. Size (`size`)6263| Label | Color | Description |64|-------|-------|-------------|65| `size:XS` | `c5def5` | Trivial change, single file |66| `size:S` | `85c1e9` | Straightforward, few files |67| `size:M` | `5dade2` | Moderate scope, some design needed |68| `size:L` | `2e86c1` | Significant feature, many files |69| `size:XL` | `1a5276` | Epic-level, major cross-cutting work |7071### 6. Parallelism (`parallelism`)7273| Label | Color | Description |74|-------|-------|-------------|75| `parallel:1` | `f0e68c` | Lane 1 work stream |76| `parallel:2` | `daa520` | Lane 2 work stream |77| `parallel:3` | `cd853f` | Lane 3 work stream |78| `parallel:4` | `b8860b` | Lane 4 work stream |79| `parallel:5` | `8b6914` | Lane 5 work stream |80| `serial` | `6c757d` | Cross-cutting — touches 2+ lanes, run alone |8182### 7. Sequencing (`sequencing`)8384| Label | Color | Description |85|-------|-------|-------------|86| `seq:01` | `006b75` | Sequence step 1 |87| `seq:02` | `006b75` | Sequence step 2 |88| `seq:03` | `006b75` | Sequence step 3 |89| `seq:04` | `006b75` | Sequence step 4 |90| `seq:05` | `006b75` | Sequence step 5 |91| `seq:06` | `006b75` | Sequence step 6 |92| `seq:07` | `006b75` | Sequence step 7 |93| `seq:08` | `006b75` | Sequence step 8 |94| `seq:09` | `006b75` | Sequence step 9 |95| `seq:10` | `006b75` | Sequence step 10 |9697### 8. Type (`type`)9899| Label | Color | Description |100|-------|-------|-------------|101| `type:bug` | `d73a4a` | Something isn't working correctly |102| `type:feature` | `0075ca` | New functionality or capability |103| `type:refactor` | `cfd3d7` | Code improvement, no behaviour change |104| `type:chore` | `ededed` | Maintenance — deps, CI, config, docs |105| `type:spike` | `d4c5f9` | Research or time-boxed exploration |106107### 9. Special (`special`)108109| Label | Color | Description |110|-------|-------|-------------|111| `ai-shippable` | `1d76db` | Delegatable to AI agents — clarity:4+ and risk:2 or lower |112| `needs-design` | `d4c5f9` | Requires design work before implementation |113114## Execution115116For each selected group, run:117118```bash119gh label create "<name>" --color "<hex>" --description "<description>" --repo "<owner/repo>" --force120```121122## Interaction Flow1231241. **Detect repo**: Run `gh repo view --json nameWithOwner -q .nameWithOwner`. If it works, offer as default. Otherwise ask.1251262. **Present groups**: Show numbered list:127 ```128 Available label groups:129 1. Priority (P1-P5) — triage priority130 2. Clarity (clarity:1-5) — issue definition quality131 3. Risk (risk:1-5) — change danger level132 4. Blast Radius (blast:1-5) — scope of impact133 5. Size (size:XS-XL) — effort estimation134 6. Parallelism (parallel:1-5 + serial) — lane assignment135 7. Sequencing (seq:01-10) — implementation order136 8. Type (type:bug, feature, refactor, chore, spike) — work category137 9. Special (ai-shippable, needs-design) — workflow flags138139 Enter numbers (e.g. "1,3,4"), "all", or ask me about any group.140 ```1411423. **Confirm**: Show total label count and target repo, ask for confirmation.1431444. **Execute**: Create labels, reporting progress grouped by category.1451465. **Summary**: Report what was created/updated, note any failures.
conorluddy