moicle 2.2.3 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. package/README.md +10 -2
  2. package/assets/commands/marketing.md +7 -7
  3. package/assets/skills/docs/sync/SKILL.md +7 -7
  4. package/assets/skills/docs/write/SKILL.md +8 -8
  5. package/assets/skills/feature/api/SKILL.md +9 -9
  6. package/assets/skills/feature/deprecate/SKILL.md +3 -3
  7. package/assets/skills/feature/new/SKILL.md +10 -10
  8. package/assets/skills/feature/refactor/SKILL.md +8 -8
  9. package/assets/skills/fix/hotfix/SKILL.md +12 -12
  10. package/assets/skills/fix/incident/SKILL.md +6 -6
  11. package/assets/skills/fix/pr-comment/SKILL.md +11 -11
  12. package/assets/skills/fix/root-cause/SKILL.md +6 -6
  13. package/assets/skills/marketing/content/SKILL.md +5 -5
  14. package/assets/skills/marketing/logo/SKILL.md +4 -4
  15. package/assets/skills/marketing/seo-blog/SKILL.md +5 -5
  16. package/assets/skills/marketing/video/SKILL.md +3 -3
  17. package/assets/skills/research/onboarding/SKILL.md +7 -7
  18. package/assets/skills/research/spike/SKILL.md +10 -10
  19. package/assets/skills/research/web/SKILL.md +8 -8
  20. package/assets/skills/review/architect/SKILL.md +12 -12
  21. package/assets/skills/review/branch/SKILL.md +6 -6
  22. package/assets/skills/review/pr/SKILL.md +8 -8
  23. package/assets/skills/review/tdd/SKILL.md +5 -5
  24. package/bin/cli.js +4 -2
  25. package/dist/commands/disable.d.ts.map +1 -1
  26. package/dist/commands/disable.js +44 -59
  27. package/dist/commands/disable.js.map +1 -1
  28. package/dist/commands/enable.d.ts.map +1 -1
  29. package/dist/commands/enable.js +45 -61
  30. package/dist/commands/enable.js.map +1 -1
  31. package/dist/commands/install/cursor-editor.d.ts +3 -0
  32. package/dist/commands/install/cursor-editor.d.ts.map +1 -0
  33. package/dist/commands/install/cursor-editor.js +114 -0
  34. package/dist/commands/install/cursor-editor.js.map +1 -0
  35. package/dist/commands/install/cursor-transform.d.ts +3 -0
  36. package/dist/commands/install/cursor-transform.d.ts.map +1 -0
  37. package/dist/commands/install/cursor-transform.js +25 -0
  38. package/dist/commands/install/cursor-transform.js.map +1 -0
  39. package/dist/commands/install/index.d.ts.map +1 -1
  40. package/dist/commands/install/index.js +5 -1
  41. package/dist/commands/install/index.js.map +1 -1
  42. package/dist/commands/install/prompts.d.ts +1 -1
  43. package/dist/commands/install/prompts.d.ts.map +1 -1
  44. package/dist/commands/install/prompts.js +1 -0
  45. package/dist/commands/install/prompts.js.map +1 -1
  46. package/dist/commands/install/skill-editor.d.ts.map +1 -1
  47. package/dist/commands/install/skill-editor.js +1 -12
  48. package/dist/commands/install/skill-editor.js.map +1 -1
  49. package/dist/commands/install/transform.d.ts +1 -0
  50. package/dist/commands/install/transform.d.ts.map +1 -1
  51. package/dist/commands/install/transform.js +6 -0
  52. package/dist/commands/install/transform.js.map +1 -1
  53. package/dist/commands/install/usage.d.ts.map +1 -1
  54. package/dist/commands/install/usage.js +20 -8
  55. package/dist/commands/install/usage.js.map +1 -1
  56. package/dist/commands/install/write-if-changed.d.ts +4 -0
  57. package/dist/commands/install/write-if-changed.d.ts.map +1 -0
  58. package/dist/commands/install/write-if-changed.js +14 -0
  59. package/dist/commands/install/write-if-changed.js.map +1 -0
  60. package/dist/commands/list.d.ts.map +1 -1
  61. package/dist/commands/list.js +41 -3
  62. package/dist/commands/list.js.map +1 -1
  63. package/dist/commands/postinstall.d.ts.map +1 -1
  64. package/dist/commands/postinstall.js +2 -1
  65. package/dist/commands/postinstall.js.map +1 -1
  66. package/dist/commands/status.d.ts.map +1 -1
  67. package/dist/commands/status.js +53 -4
  68. package/dist/commands/status.js.map +1 -1
  69. package/dist/commands/uninstall.d.ts.map +1 -1
  70. package/dist/commands/uninstall.js +91 -4
  71. package/dist/commands/uninstall.js.map +1 -1
  72. package/dist/utils/editor-constants.d.ts +5 -0
  73. package/dist/utils/editor-constants.d.ts.map +1 -0
  74. package/dist/utils/editor-constants.js +5 -0
  75. package/dist/utils/editor-constants.js.map +1 -0
  76. package/dist/utils/editor-items.d.ts +11 -0
  77. package/dist/utils/editor-items.d.ts.map +1 -0
  78. package/dist/utils/editor-items.js +57 -0
  79. package/dist/utils/editor-items.js.map +1 -0
  80. package/dist/utils/symlink.d.ts +1 -0
  81. package/dist/utils/symlink.d.ts.map +1 -1
  82. package/dist/utils/symlink.js +7 -5
  83. package/dist/utils/symlink.js.map +1 -1
  84. package/package.json +1 -1
package/README.md CHANGED
@@ -25,9 +25,11 @@ A toolkit to bootstrap and accelerate project development with Claude Code throu
25
25
  - [x] Claude
26
26
  - [x] Codex CLI
27
27
  - [x] Antigravity
28
- - [ ] Cursor
28
+ - [x] Cursor
29
29
  - [ ] Windsurf
30
30
 
31
+ Older MoiCle versions merged agents into `~/.cursor/AGENTS.md`. Re-run `moicle install --target cursor` for native `.cursor/rules/*.mdc` layout; you may delete legacy `AGENTS.md` manually.
32
+
31
33
  ## Installation
32
34
 
33
35
  ```bash
@@ -46,6 +48,10 @@ moicle install --target codex --global
46
48
  # Install for Antigravity
47
49
  moicle install --target antigravity --global
48
50
 
51
+ # Install for Cursor (rules, commands, skills, architecture)
52
+ moicle install --target cursor --global
53
+ moicle install --target cursor --project
54
+
49
55
  # Choose:
50
56
  # 1. Pick Claude Code, Codex CLI, or Antigravity
51
57
  # 2. Pick global or project scope
@@ -60,7 +66,9 @@ moicle install --target antigravity --global
60
66
  | `moicle install --project` | Install to ./.claude/ (copies) |
61
67
  | `moicle install --target codex --global` | Install Codex skills + architecture to ~/.codex/ |
62
68
  | `moicle install --target codex --project` | Install Codex skills + architecture to ./.codex/ |
63
- | `moicle list` | List all installed items |
69
+ | `moicle install --target cursor --global` | Install Cursor rules, commands, skills to ~/.cursor/ |
70
+ | `moicle install --target cursor --project` | Install Cursor assets to ./.cursor/ |
71
+ | `moicle list --target cursor` | List Cursor rules, commands, and skills |
64
72
  | `moicle status` | Show enabled/disabled status |
65
73
  | `moicle enable <item>` | Enable an agent/command/skill |
66
74
  | `moicle disable <item>` | Disable an agent/command/skill |
@@ -30,13 +30,13 @@ Let the user choose which areas to focus on:
30
30
  Which marketing areas do you want to plan?
31
31
 
32
32
  1. Logo & Brand Identity — Design logo, colors, typography, brand guidelines
33
- Triggers skill: /marketing:logo
33
+ Triggers skill: /marketing-logo
34
34
 
35
35
  2. Video Content Strategy — Plan video series, scripts, production, publishing
36
- Triggers skill: /marketing:video
36
+ Triggers skill: /marketing-video
37
37
 
38
38
  3. Content Writing Strategy — Blog posts, social media, SEO, newsletter
39
- Triggers skill: /marketing:content
39
+ Triggers skill: /marketing-content
40
40
 
41
41
  4. All of the Above — Complete marketing plan (Recommended)
42
42
 
@@ -55,19 +55,19 @@ MARKETING PLAN WORKFLOW
55
55
 
56
56
  Phase 1: Brand Foundation
57
57
 
58
- ├── Execute: /marketing:logo skill
58
+ ├── Execute: /marketing-logo skill
59
59
  │ └── Output: Brand guidelines, color palette, typography
60
60
 
61
61
 
62
62
  Phase 2: Content Strategy
63
63
 
64
- ├── Execute: /marketing:content skill
64
+ ├── Execute: /marketing-content skill
65
65
  │ └── Output: Content pillars, blog plan, social media plan, newsletter
66
66
 
67
67
 
68
68
  Phase 3: Video Content
69
69
 
70
- ├── Execute: /marketing:video skill
70
+ ├── Execute: /marketing-video skill
71
71
  │ └── Output: Video series, scripts, production specs, calendar
72
72
 
73
73
 
@@ -85,7 +85,7 @@ Phase 5: Launch Plan
85
85
 
86
86
  ### Execution Notes:
87
87
  - Run skills sequentially — brand identity informs content and video decisions
88
- - Pass brand guidelines (colors, voice, tone) from /marketing:logo into /marketing:content and /marketing:video
88
+ - Pass brand guidelines (colors, voice, tone) from /marketing-logo into /marketing-content and /marketing-video
89
89
  - Ensure consistency across all outputs
90
90
 
91
91
  ## Step 4: Create Unified Calendar
@@ -12,9 +12,9 @@ Generate a complete `docs/` site (business overview, architecture, use cases wit
12
12
  - ✅ Re-generate the whole `docs/` site from current code
13
13
  - ✅ Existing docs have drifted; want batch sync with review loop
14
14
  - ✅ Project has no structured docs at all
15
- - ❌ Authoring a single doc by hand (README / API.md only) → use `/docs:write`
16
- - ❌ Understand the codebase, not document it → use `/research:onboarding`
17
- - ❌ Adding doc for one endpoint → use `/feature:api` Phase 4
15
+ - ❌ Authoring a single doc by hand (README / API.md only) → use `/docs-write`
16
+ - ❌ Understand the codebase, not document it → use `/research-onboarding`
17
+ - ❌ Adding doc for one endpoint → use `/feature-api` Phase 4
18
18
 
19
19
  ## Read Architecture First
20
20
 
@@ -229,10 +229,10 @@ For each iteration:
229
229
 
230
230
  | When | Use |
231
231
  |------|-----|
232
- | Author single doc by hand | `/docs:write` |
233
- | Onboard self / new dev | `/research:onboarding` |
234
- | Doc only one new endpoint | `/feature:api` Phase 4 |
235
- | Architecture itself needs review | `/review:architect` |
232
+ | Author single doc by hand | `/docs-write` |
233
+ | Onboard self / new dev | `/research-onboarding` |
234
+ | Doc only one new endpoint | `/feature-api` Phase 4 |
235
+ | Architecture itself needs review | `/review-architect` |
236
236
 
237
237
  ## Recommended Agents
238
238
 
@@ -5,15 +5,15 @@ description: Documentation workflow for authoring project documentation manually
5
5
 
6
6
  # Documentation Workflow
7
7
 
8
- Hand-author project docs (README, API.md, ARCHITECTURE.md, CONTRIBUTING.md) with full control over voice and structure. For automated batch generation of a whole `docs/` tree with a review loop, use `/docs:sync` instead.
8
+ Hand-author project docs (README, API.md, ARCHITECTURE.md, CONTRIBUTING.md) with full control over voice and structure. For automated batch generation of a whole `docs/` tree with a review loop, use `/docs-sync` instead.
9
9
 
10
10
  ## When to use this skill
11
11
 
12
12
  - ✅ Authoring or updating a specific document
13
13
  - ✅ Need opinionated prose, not just structure
14
14
  - ✅ Doc is small / scoped — a single file or section
15
- - ❌ Want automated multi-doc generation → use `/docs:sync`
16
- - ❌ Just need API reference from OpenAPI → use `/feature:api` Phase 4
15
+ - ❌ Want automated multi-doc generation → use `/docs-sync`
16
+ - ❌ Just need API reference from OpenAPI → use `/feature-api` Phase 4
17
17
 
18
18
  ## Read Architecture First
19
19
 
@@ -108,7 +108,7 @@ For each doc define:
108
108
 
109
109
  ### Minimal skeletons
110
110
 
111
- Use these as starting points. For full templates, see `/docs:sync` (which generates the full set).
111
+ Use these as starting points. For full templates, see `/docs-sync` (which generates the full set).
112
112
 
113
113
  **README.md** (≤80 lines for most projects)
114
114
  ```markdown
@@ -258,10 +258,10 @@ If any issue → return to Phase 3 for that doc, fix, re-review.
258
258
 
259
259
  | When | Use |
260
260
  |------|-----|
261
- | Generate full doc site from codebase | `/docs:sync` |
262
- | Document a newly added API endpoint | `/feature:api` Phase 4 |
263
- | Onboard self / new dev | `/research:onboarding` |
264
- | Write blog / social content | `/marketing:content` |
261
+ | Generate full doc site from codebase | `/docs-sync` |
262
+ | Document a newly added API endpoint | `/feature-api` Phase 4 |
263
+ | Onboard self / new dev | `/research-onboarding` |
264
+ | Write blog / social content | `/marketing-content` |
265
265
 
266
266
  ## Recommended Agents
267
267
 
@@ -13,8 +13,8 @@ End-to-end workflow for designing, implementing, testing, and documenting APIs
13
13
  - ✅ Integrating a third-party API (Stripe, OpenAI, etc.) into the system
14
14
  - ✅ Replacing or upgrading an existing API integration
15
15
  - ❌ Just need a one-off HTTP call in a script → use Bash directly
16
- - ❌ Need to research which API to use → use `/research:web` first
17
- - ❌ Building a whole new domain → use `/feature:new` (which calls this skill internally for the API surface)
16
+ - ❌ Need to research which API to use → use `/research-web` first
17
+ - ❌ Building a whole new domain → use `/feature-new` (which calls this skill internally for the API surface)
18
18
 
19
19
  ---
20
20
 
@@ -160,7 +160,7 @@ GET /resource?cursor=<opaque>&limit=<int 1..100, default 20>
160
160
 
161
161
  ### What to update
162
162
  1. **OpenAPI spec** committed to repo (`openapi.yaml` or per-resource files)
163
- 2. **API.md** — append the new endpoint(s) (or refer to `/docs:write` skill for full re-author)
163
+ 2. **API.md** — append the new endpoint(s) (or refer to `/docs-write` skill for full re-author)
164
164
  3. **CHANGELOG.md** — note breaking / additive changes
165
165
  4. **README.md** — if this changes quick-start
166
166
 
@@ -201,11 +201,11 @@ Create a resource. Idempotent via `Idempotency-Key` header.
201
201
 
202
202
  ## Phase 5: REVIEW LOOP
203
203
 
204
- Run `/review:architect` for the touched domain. Loop until score ≥ B.
204
+ Run `/review-architect` for the touched domain. Loop until score ≥ B.
205
205
 
206
206
  ```
207
207
  LOOP:
208
- 1. Run /review:architect {stack} {domain}
208
+ 1. Run /review-architect {stack} {domain}
209
209
  2. Fix violations
210
210
  3. Re-run tests + build
211
211
  4. GOTO 1 (until score ≥ B)
@@ -257,10 +257,10 @@ LOOP:
257
257
  | When | Use |
258
258
  |------|-----|
259
259
  | Designing the API contract from scratch | `@api-designer` agent |
260
- | Adding the endpoint as part of a larger feature | `/feature:new` (calls this internally) |
261
- | Writing tests for the endpoint | `/review:tdd` |
262
- | Documenting the full API surface | `/docs:write` |
263
- | Reviewing architecture compliance | `/review:architect` |
260
+ | Adding the endpoint as part of a larger feature | `/feature-new` (calls this internally) |
261
+ | Writing tests for the endpoint | `/review-tdd` |
262
+ | Documenting the full API surface | `/docs-write` |
263
+ | Reviewing architecture compliance | `/review-architect` |
264
264
 
265
265
  ---
266
266
 
@@ -255,10 +255,10 @@ class OldWidget { ... }
255
255
 
256
256
  | When | Use |
257
257
  |------|-----|
258
- | Adding the replacement first | `/feature:new` |
258
+ | Adding the replacement first | `/feature-new` |
259
259
  | Restructuring the code that uses the deprecated thing | `refactor` |
260
- | Documenting the migration guide | `/docs:write` |
261
- | Reviewing the removal PR | `/review:pr` |
260
+ | Documenting the migration guide | `/docs-write` |
261
+ | Reviewing the removal PR | `/review-pr` |
262
262
 
263
263
  ---
264
264
 
@@ -15,9 +15,9 @@ Build a new feature following DDD layers with rule checks per phase and a final
15
15
  - ✅ Feature spans multiple DDD layers (domain + app + infra)
16
16
  - ✅ The approach is well-understood (no major research / prototype needed)
17
17
  - ✅ You want automated architecture review at the end
18
- - ❌ Quick bug fix → use `/fix:hotfix`
19
- - ❌ Don't know the right approach yet → `/research:web` or `/research:spike` first
20
- - ❌ Restructuring existing code → use `/feature:refactor`
18
+ - ❌ Quick bug fix → use `/fix-hotfix`
19
+ - ❌ Don't know the right approach yet → `/research-web` or `/research-spike` first
20
+ - ❌ Restructuring existing code → use `/feature-refactor`
21
21
 
22
22
  ## Read Architecture First
23
23
 
@@ -205,7 +205,7 @@ Build in order: **value objects → entities → events → ports → usecases**
205
205
 
206
206
  ```
207
207
  LOOP:
208
- 1. /review:architect {stack} {domain}
208
+ 1. /review-architect {stack} {domain}
209
209
  2. IF violations severity ≥ MEDIUM:
210
210
  fix all → build → tests → GOTO 1
211
211
  3. IF score ≥ B → BREAK
@@ -253,12 +253,12 @@ LOOP:
253
253
 
254
254
  | When | Use |
255
255
  |------|-----|
256
- | Don't know approach yet | `/research:web` → then this skill |
257
- | Want to validate by prototyping | `/research:spike` → then this skill |
258
- | Adding only an endpoint | `/feature:api` |
259
- | Restructuring existing module | `/feature:refactor` |
260
- | Architecture check (called automatically in Phase 7) | `/review:architect` |
261
- | Write tests inline (TDD style) | `/review:tdd` |
256
+ | Don't know approach yet | `/research-web` → then this skill |
257
+ | Want to validate by prototyping | `/research-spike` → then this skill |
258
+ | Adding only an endpoint | `/feature-api` |
259
+ | Restructuring existing module | `/feature-refactor` |
260
+ | Architecture check (called automatically in Phase 7) | `/review-architect` |
261
+ | Write tests inline (TDD style) | `/review-tdd` |
262
262
 
263
263
  ## Recommended Agents
264
264
 
@@ -15,9 +15,9 @@ Restructure existing code into DDD layers, or fix drift in an existing DDD modul
15
15
  - ✅ Migrating a legacy module into DDD layers
16
16
  - ✅ Existing DDD module has drifted (fat controller, anemic entity, mixed concerns)
17
17
  - ✅ Splitting one domain into multiple bounded contexts
18
- - ❌ Building a brand-new feature → use `/feature:new`
18
+ - ❌ Building a brand-new feature → use `/feature-new`
19
19
  - ❌ Just renaming files / variables → just do it
20
- - ❌ Fixing a bug → use `/fix:hotfix` or `/fix:root-cause`
20
+ - ❌ Fixing a bug → use `/fix-hotfix` or `/fix-root-cause`
21
21
 
22
22
  ## Read Architecture First
23
23
 
@@ -196,11 +196,11 @@ grep -r "{old_import_path}" --include="*.{ext}" . && echo "FAIL: stale imports"
196
196
 
197
197
  ## Review Loop
198
198
 
199
- After Phase 6, call `/review:architect {stack} {domain}`. Loop until score ≥ B.
199
+ After Phase 6, call `/review-architect {stack} {domain}`. Loop until score ≥ B.
200
200
 
201
201
  ```
202
202
  LOOP:
203
- 1. /review:architect {stack} {domain}
203
+ 1. /review-architect {stack} {domain}
204
204
  2. IF violations severity ≥ MEDIUM:
205
205
  fix all → full build → all tests → GOTO 1
206
206
  3. IF score ≥ B → BREAK
@@ -252,10 +252,10 @@ LOOP:
252
252
 
253
253
  | When | Use |
254
254
  |------|-----|
255
- | Building from scratch (no existing code) | `/feature:new` |
256
- | Just adding tests to untested code | `/review:tdd` |
257
- | Reviewing the refactor before merging | `/review:branch` |
258
- | Final architecture check (called automatically in review loop) | `/review:architect` |
255
+ | Building from scratch (no existing code) | `/feature-new` |
256
+ | Just adding tests to untested code | `/review-tdd` |
257
+ | Reviewing the refactor before merging | `/review-branch` |
258
+ | Final architecture check (called automatically in review loop) | `/review-architect` |
259
259
 
260
260
  ## Recommended Agents
261
261
 
@@ -12,9 +12,9 @@ Fast-track bug fix with a rollback plan. Use when the cause is identifiable in u
12
12
  - ✅ Bug is reproducible and root cause is clear (or quickly identifiable)
13
13
  - ✅ Need a fix shipped fast with a rollback plan
14
14
  - ✅ Severity ranges from low (minor UI) to high (feature broken)
15
- - ❌ Production is down right now → use `/fix:incident` first
16
- - ❌ Bug has been "fixed" multiple times and keeps returning → use `/fix:root-cause`
17
- - ❌ Building a new feature → use `/feature:new`
15
+ - ❌ Production is down right now → use `/fix-incident` first
16
+ - ❌ Bug has been "fixed" multiple times and keeps returning → use `/fix-root-cause`
17
+ - ❌ Building a new feature → use `/feature-new`
18
18
 
19
19
  ## Read Architecture First
20
20
 
@@ -22,7 +22,7 @@ Read `ddd-architecture.md` + stack-specific doc — the fix must land in the rig
22
22
 
23
23
  ## Severity
24
24
 
25
- Use `~/.claude/architecture/_shared/severity-levels.md` (incident table). Hotfix typically covers P2-P4. P1 → start with `/fix:incident` for triage / comms.
25
+ Use `~/.claude/architecture/_shared/severity-levels.md` (incident table). Hotfix typically covers P2-P4. P1 → start with `/fix-incident` for triage / comms.
26
26
 
27
27
  ---
28
28
 
@@ -61,7 +61,7 @@ IDENTIFY → REPRODUCE → FIX → VERIFY → DEPLOY
61
61
  - [ ] Error captured verbatim
62
62
  - [ ] Reproduction steps known (or "intermittent" noted)
63
63
  - [ ] Severity assigned (P2 / P3 / P4)
64
- - [ ] Root cause identified (use `/fix:root-cause` if 5 Whys doesn't converge)
64
+ - [ ] Root cause identified (use `/fix-root-cause` if 5 Whys doesn't converge)
65
65
 
66
66
  ---
67
67
 
@@ -91,7 +91,7 @@ IDENTIFY → REPRODUCE → FIX → VERIFY → DEPLOY
91
91
  ### Rules
92
92
  - Fix at the **root cause**, not the symptom
93
93
  - Land the fix in the right layer (boundary validation → handler/DTO; business rule → usecase; data shape → infra mapper)
94
- - **Add a regression test first** (RED), then make it pass (GREEN). See `/review:tdd`.
94
+ - **Add a regression test first** (RED), then make it pass (GREEN). See `/review-tdd`.
95
95
  - Don't refactor on the fix — separate PR
96
96
  - If the fix requires schema migration, plan it as 2 deploys (compatible code first, then migration)
97
97
 
@@ -131,7 +131,7 @@ For data-shape bugs (null where not expected, type mismatch from external API):
131
131
  ## Phase 5: DEPLOY
132
132
 
133
133
  ### Pre-deploy checklist
134
- - [ ] PR reviewed (`/review:branch` self + `/review:pr` from teammate)
134
+ - [ ] PR reviewed (`/review-branch` self + `/review-pr` from teammate)
135
135
  - [ ] Rollback plan documented (see below)
136
136
  - [ ] On-call notified
137
137
  - [ ] CHANGELOG entry
@@ -215,11 +215,11 @@ Document **before** deploying:
215
215
 
216
216
  | When | Use |
217
217
  |------|-----|
218
- | Production is down right now | `/fix:incident` first, then hotfix |
219
- | Bug keeps coming back after fixes | `/fix:root-cause` |
220
- | Need to write regression test first | `/review:tdd` |
221
- | Bug is on an open PR | `/fix:pr-comment` |
222
- | Self-review before opening PR | `/review:branch` |
218
+ | Production is down right now | `/fix-incident` first, then hotfix |
219
+ | Bug keeps coming back after fixes | `/fix-root-cause` |
220
+ | Need to write regression test first | `/review-tdd` |
221
+ | Bug is on an open PR | `/fix-pr-comment` |
222
+ | Self-review before opening PR | `/review-branch` |
223
223
 
224
224
  ## Recommended Agents
225
225
 
@@ -12,8 +12,8 @@ Structured workflow for handling production incidents from triage to postmortem.
12
12
  - ✅ Production is down or degraded right now
13
13
  - ✅ Users are impacted, on-call has been paged
14
14
  - ✅ Need to coordinate response, mitigation, comms, and postmortem
15
- - ❌ Bug is reported but no users impacted → use `/fix:hotfix`
16
- - ❌ Already mitigated, need to find root cause → use `/fix:root-cause`
15
+ - ❌ Bug is reported but no users impacted → use `/fix-hotfix`
16
+ - ❌ Already mitigated, need to find root cause → use `/fix-root-cause`
17
17
  - ❌ Postmortem only, no active incident → jump to Phase 5
18
18
 
19
19
  ---
@@ -205,7 +205,7 @@ Live walkthrough (5-10 min): outgoing IC walks incoming IC through the timeline
205
205
  **Goal:** apply the permanent fix and verify.
206
206
 
207
207
  ### Actions
208
- 1. Confirm root cause (use `/fix:root-cause` workflow if not obvious)
208
+ 1. Confirm root cause (use `/fix-root-cause` workflow if not obvious)
209
209
  2. Implement permanent fix following stack architecture
210
210
  3. Add test that would have caught this
211
211
  4. Deploy fix through normal pipeline (don't skip CI even under pressure — unless explicitly authorized)
@@ -340,10 +340,10 @@ Postmortem: {date} — link to come
340
340
 
341
341
  | When | Use |
342
342
  |------|-----|
343
- | Bug reported but no active incident | `/fix:hotfix` |
344
- | Root cause unclear, need deep investigation | `/fix:root-cause` |
343
+ | Bug reported but no active incident | `/fix-hotfix` |
344
+ | Root cause unclear, need deep investigation | `/fix-root-cause` |
345
345
  | Need to roll back deployment | (use ops runbook, not a skill) |
346
- | Documenting postmortem as a doc | `/docs:write` |
346
+ | Documenting postmortem as a doc | `/docs-write` |
347
347
 
348
348
  ---
349
349
 
@@ -15,9 +15,9 @@ Fetch all review comments on an open PR, address each, push, and respond back to
15
15
  - ✅ Reviewer left comments and you need to address each one
16
16
  - ✅ Want to track which comments are resolved vs still open
17
17
  - ✅ Need structured responses posted back to GitHub
18
- - ❌ You are the reviewer → use `/review:pr`
19
- - ❌ No PR yet → use `/review:branch`
20
- - ❌ Fix is a brand-new bug surfaced by reviewer → `/fix:hotfix` first, then this skill
18
+ - ❌ You are the reviewer → use `/review-pr`
19
+ - ❌ No PR yet → use `/review-branch`
20
+ - ❌ Fix is a brand-new bug surfaced by reviewer → `/fix-hotfix` first, then this skill
21
21
 
22
22
  ---
23
23
 
@@ -86,15 +86,15 @@ Build a triage table:
86
86
  - Fix in order: must-fix → should-fix → discussion outcomes
87
87
  - One concern per commit (`fix(handler): validate input in DTO per #pr-comment-1`)
88
88
  - After each batch: run build + lint + tests locally
89
- - Re-run `/review:branch` before pushing
89
+ - Re-run `/review-branch` before pushing
90
90
 
91
91
  ### When the fix changes architecture
92
- If a comment requests something structural (move logic between layers, add a port), use `/feature:refactor` for that subtree, then come back here to respond.
92
+ If a comment requests something structural (move logic between layers, add a port), use `/feature-refactor` for that subtree, then come back here to respond.
93
93
 
94
94
  ### Gate
95
95
  - [ ] All must-fix items addressed
96
96
  - [ ] Build + lint + tests green
97
- - [ ] Self-review with `/review:branch` clean
97
+ - [ ] Self-review with `/review-branch` clean
98
98
 
99
99
  ---
100
100
 
@@ -162,7 +162,7 @@ gh pr edit $PR --add-reviewer {original_reviewer}
162
162
  - **Reply to every comment** — silence reads as ignoring
163
163
  - **Push back politely** when you have a real reason; never just close threads
164
164
  - **One concern per commit** — easier for reviewer to verify
165
- - **Run `/review:branch` before pushing** — catch easy issues before reviewer round 2
165
+ - **Run `/review-branch` before pushing** — catch easy issues before reviewer round 2
166
166
  - **Don't argue style** when the team has a linter — let the tool decide
167
167
 
168
168
  ---
@@ -171,10 +171,10 @@ gh pr edit $PR --add-reviewer {original_reviewer}
171
171
 
172
172
  | When | Use |
173
173
  |------|-----|
174
- | You are the reviewer | `/review:pr` |
175
- | Self-review before pushing again | `/review:branch` |
176
- | Reviewer asked for architectural refactor | `/feature:refactor` |
177
- | Reviewer surfaced a bug needing investigation | `/fix:root-cause` |
174
+ | You are the reviewer | `/review-pr` |
175
+ | Self-review before pushing again | `/review-branch` |
176
+ | Reviewer asked for architectural refactor | `/feature-refactor` |
177
+ | Reviewer surfaced a bug needing investigation | `/fix-root-cause` |
178
178
 
179
179
  ## Recommended Agents
180
180
 
@@ -14,8 +14,8 @@ For bugs that have been "fixed" multiple times and keep coming back, intermitten
14
14
  - ✅ Error inside vendor / framework internals
15
15
  - ✅ Local vs production behavior differs
16
16
  - ✅ Race condition / concurrency suspected
17
- - ❌ Bug is well understood, just needs a fix → `/fix:hotfix`
18
- - ❌ Production is down with user impact → `/fix:incident` first, then this skill
17
+ - ❌ Bug is well understood, just needs a fix → `/fix-hotfix`
18
+ - ❌ Production is down with user impact → `/fix-incident` first, then this skill
19
19
 
20
20
  ---
21
21
 
@@ -259,10 +259,10 @@ For data-shape bugs from external sources: validate / coerce at the adapter, not
259
259
 
260
260
  | When | Use |
261
261
  |------|-----|
262
- | Bug is understood, just needs a fix | `/fix:hotfix` |
263
- | Production is down | `/fix:incident` (then this skill after mitigation) |
264
- | Write regression test after fix | `/review:tdd` |
265
- | Research how others solved similar bugs | `/research:web` |
262
+ | Bug is understood, just needs a fix | `/fix-hotfix` |
263
+ | Production is down | `/fix-incident` (then this skill after mitigation) |
264
+ | Write regression test after fix | `/review-tdd` |
265
+ | Research how others solved similar bugs | `/research-web` |
266
266
 
267
267
  ## Recommended Agents
268
268
 
@@ -12,9 +12,9 @@ Workflow for creating content strategy: audience research, content pillars, SEO
12
12
  - ✅ Building a content strategy from scratch (pillars, calendar, channels)
13
13
  - ✅ Writing one specific piece (blog post, newsletter, social thread)
14
14
  - ✅ Repurposing one piece into multi-channel content
15
- - ❌ Writing API / project documentation → use `/docs:write` or `/docs:sync`
15
+ - ❌ Writing API / project documentation → use `/docs-write` or `/docs-sync`
16
16
  - ❌ Writing release notes / changelog → use git history + manual
17
- - ❌ Designing a video → use `/marketing:video`
17
+ - ❌ Designing a video → use `/marketing-video`
18
18
 
19
19
  ---
20
20
 
@@ -251,10 +251,10 @@ SIGNATURE
251
251
 
252
252
  | When | Use |
253
253
  |------|-----|
254
- | Building brand identity (logo + colors) | `/marketing:logo` |
255
- | Creating video scripts / storyboards | `/marketing:video` |
254
+ | Building brand identity (logo + colors) | `/marketing-logo` |
255
+ | Creating video scripts / storyboards | `/marketing-video` |
256
256
  | Building a full marketing plan | `/marketing` (combines all three) |
257
- | Writing project documentation | `/docs:write` |
257
+ | Writing project documentation | `/docs-write` |
258
258
 
259
259
  ---
260
260
 
@@ -14,7 +14,7 @@ Produce a logo + brand identity **specification** that a designer can execute (o
14
14
  - ✅ Need a deliverable spec for a designer to execute
15
15
  - ❌ Just need a quick icon variation → use a design tool directly
16
16
  - ❌ Full marketing plan (logo + content + video) → use `/marketing`
17
- - ❌ Video-specific visuals → use `/marketing:video`
17
+ - ❌ Video-specific visuals → use `/marketing-video`
18
18
 
19
19
  ---
20
20
 
@@ -238,9 +238,9 @@ Pick 1 display + 1 body font (or 1 font in 2 weights). Note:
238
238
  | When | Use |
239
239
  |------|-----|
240
240
  | Full marketing plan (logo + content + video) | `/marketing` |
241
- | Write content with the brand | `/marketing:content` |
242
- | Create video with the brand | `/marketing:video` |
243
- | Document brand guidelines as a doc | `/docs:write` |
241
+ | Write content with the brand | `/marketing-content` |
242
+ | Create video with the brand | `/marketing-video` |
243
+ | Document brand guidelines as a doc | `/docs-write` |
244
244
 
245
245
  ## Recommended Agents
246
246
 
@@ -12,7 +12,7 @@ Write **one** evergreen blog post that ranks on traditional search AND is easy f
12
12
  - ✅ Writing a single evergreen blog post (entity / trust / compare / glossary / use-case / FAQ)
13
13
  - ✅ Updating an existing evergreen post that has drifted
14
14
  - ✅ Replacing a thin / outdated post with a stronger version on the same intent
15
- - ❌ Multi-post content plan / calendar / strategy → use `/marketing:content`
15
+ - ❌ Multi-post content plan / calendar / strategy → use `/marketing-content`
16
16
  - ❌ Changelog / feature launch / release announcement → write manually or use a feature-blog template
17
17
  - ❌ Time-sensitive news / event post → not evergreen, different rules
18
18
 
@@ -350,11 +350,11 @@ head -30 {blog_dir}/{slug}.md
350
350
 
351
351
  | When | Use |
352
352
  |------|-----|
353
- | Multi-post content plan / calendar / strategy | `/marketing:content` |
354
- | Brand voice / visual identity setup first | `/marketing:logo` |
355
- | Video / shorts version of the post | `/marketing:video` |
353
+ | Multi-post content plan / calendar / strategy | `/marketing-content` |
354
+ | Brand voice / visual identity setup first | `/marketing-logo` |
355
+ | Video / shorts version of the post | `/marketing-video` |
356
356
  | Full go-to-market plan (logo + content + video) | `/marketing` command |
357
- | Writing technical project docs (not blog) | `/docs:write` |
357
+ | Writing technical project docs (not blog) | `/docs-write` |
358
358
 
359
359
  ## Recommended Agents
360
360
 
@@ -14,7 +14,7 @@ Plan video content end-to-end: strategy, script, storyboard, production spec, pu
14
14
  - ✅ Repurposing existing long-form into shorts / clips
15
15
  - ❌ Just need ideas, not a plan → use `brainstorm`
16
16
  - ❌ Want full marketing plan (logo + content + video) → use `/marketing`
17
- - ❌ Writing a blog post or thread → use `/marketing:content`
17
+ - ❌ Writing a blog post or thread → use `/marketing-content`
18
18
 
19
19
  ---
20
20
 
@@ -241,8 +241,8 @@ CTA (≤10 sec)
241
241
  | When | Use |
242
242
  |------|-----|
243
243
  | Full marketing plan (logo + content + video) | `/marketing` |
244
- | Need brand visuals first | `/marketing:logo` |
245
- | Repurpose video → blog / threads | `/marketing:content` |
244
+ | Need brand visuals first | `/marketing-logo` |
245
+ | Repurpose video → blog / threads | `/marketing-content` |
246
246
  | Brainstorm video topics | `brainstorm` |
247
247
 
248
248
  ---
@@ -12,8 +12,8 @@ Ramp up on a new codebase quickly: structure, conventions, where things live, ho
12
12
  - ✅ Just joined a project / repo and need to ramp up
13
13
  - ✅ Returning to a codebase you haven't touched in months
14
14
  - ✅ Need to give a teammate a structured walkthrough
15
- - ❌ Want to generate full docs site → use `/docs:sync`
16
- - ❌ Need to fix a specific bug → use `/fix:hotfix` / `/fix:root-cause`
15
+ - ❌ Want to generate full docs site → use `/docs-sync`
16
+ - ❌ Need to fix a specific bug → use `/fix-hotfix` / `/fix-root-cause`
17
17
  - ❌ Only want a quick file lookup → just use `grep` / `find`
18
18
 
19
19
  ## Read Architecture First
@@ -158,7 +158,7 @@ git shortlog -sn --since=3months | head -10
158
158
  - [ ] Followed naming + error-handling conventions
159
159
  - [ ] Commit message matches project style (`git log --oneline`)
160
160
  - [ ] PR description follows template (check `.github/PULL_REQUEST_TEMPLATE.md`)
161
- - [ ] Self-reviewed with `/review:branch` before opening PR
161
+ - [ ] Self-reviewed with `/review-branch` before opening PR
162
162
 
163
163
  ### Who to ask
164
164
  - Architecture / "why is it like this": {tech lead from git shortlog}
@@ -208,10 +208,10 @@ git shortlog -sn --since=3months | head -10
208
208
 
209
209
  | When | Use |
210
210
  |------|-----|
211
- | Generate full doc site after onboarding | `/docs:sync` |
212
- | Build first real feature after onboarding | `/feature:new` |
213
- | First bug fix to learn the codebase | `/fix:hotfix` |
214
- | Author / update the onboarding doc itself | `/docs:write` |
211
+ | Generate full doc site after onboarding | `/docs-sync` |
212
+ | Build first real feature after onboarding | `/feature-new` |
213
+ | First bug fix to learn the codebase | `/fix-hotfix` |
214
+ | Author / update the onboarding doc itself | `/docs-write` |
215
215
 
216
216
  ## Recommended Agents
217
217