moicle 2.0.0 → 2.2.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 (43) hide show
  1. package/README.md +20 -9
  2. package/assets/architecture/_shared/severity-levels.md +34 -0
  3. package/assets/architecture/_shared/stack-detection.md +34 -0
  4. package/assets/commands/marketing.md +7 -7
  5. package/assets/skills/docs/sync/SKILL.md +159 -519
  6. package/assets/skills/docs/write/SKILL.md +89 -186
  7. package/assets/skills/feature/new/SKILL.md +152 -192
  8. package/assets/skills/feature/refactor/SKILL.md +152 -233
  9. package/assets/skills/fix/hotfix/SKILL.md +139 -305
  10. package/assets/skills/fix/incident/SKILL.md +107 -19
  11. package/assets/skills/fix/pr-comment/SKILL.md +98 -224
  12. package/assets/skills/fix/root-cause/SKILL.md +161 -104
  13. package/assets/skills/{docs → marketing}/content/SKILL.md +4 -4
  14. package/assets/skills/marketing/logo/SKILL.md +252 -0
  15. package/assets/skills/marketing/seo-blog/SKILL.md +367 -0
  16. package/assets/skills/marketing/video/SKILL.md +258 -0
  17. package/assets/skills/research/onboarding/SKILL.md +127 -510
  18. package/assets/skills/research/spike/SKILL.md +128 -436
  19. package/assets/skills/research/web/SKILL.md +124 -83
  20. package/assets/skills/review/architect/SKILL.md +157 -306
  21. package/assets/skills/review/branch/SKILL.md +153 -208
  22. package/assets/skills/review/pr/SKILL.md +129 -519
  23. package/assets/skills/review/tdd/SKILL.md +108 -69
  24. package/bin/cli.js +2 -2
  25. package/dist/commands/install.d.ts.map +1 -1
  26. package/dist/commands/install.js +176 -8
  27. package/dist/commands/install.js.map +1 -1
  28. package/dist/commands/list.d.ts.map +1 -1
  29. package/dist/commands/list.js +31 -1
  30. package/dist/commands/list.js.map +1 -1
  31. package/dist/commands/status.d.ts.map +1 -1
  32. package/dist/commands/status.js +30 -1
  33. package/dist/commands/status.js.map +1 -1
  34. package/dist/commands/uninstall.d.ts.map +1 -1
  35. package/dist/commands/uninstall.js +64 -8
  36. package/dist/commands/uninstall.js.map +1 -1
  37. package/dist/utils/symlink.d.ts +1 -0
  38. package/dist/utils/symlink.d.ts.map +1 -1
  39. package/dist/utils/symlink.js +8 -6
  40. package/dist/utils/symlink.js.map +1 -1
  41. package/package.json +1 -1
  42. package/assets/skills/docs/logo/SKILL.md +0 -492
  43. package/assets/skills/docs/video/SKILL.md +0 -666
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "moicle",
3
- "version": "2.0.0",
3
+ "version": "2.2.0",
4
4
  "description": "Reusable AI agents, commands, skills, and architecture references for Claude Code",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -1,492 +0,0 @@
1
- ---
2
- name: docs-logo
3
- description: Generate comprehensive logo design specifications, brand identity guidelines, and visual concepts. Use when user says "design logo", "create logo", "brand identity", "logo concept", "visual identity".
4
- ---
5
-
6
- # Logo Design Skill
7
-
8
- Structured workflow for creating professional logo design specifications, brand guidelines, and visual identity systems.
9
-
10
- ## When to use this skill
11
-
12
- - ✅ Brand new identity (no existing logo)
13
- - ✅ Rebrand / refresh of an existing logo + guidelines
14
- - ✅ Need a deliverable spec for a designer to execute
15
- - ❌ Just need a quick icon variation → use a design tool directly
16
- - ❌ Want a full marketing plan (logo + content + video) → use `/marketing`
17
- - ❌ Need video brand visuals → use `/docs:video`
18
-
19
- ## Workflow
20
-
21
- ```
22
- DISCOVER → CONCEPT → DESIGN → REFINE → DELIVER
23
- ```
24
-
25
- ---
26
-
27
- ## Phase 1: DISCOVER
28
-
29
- **Goal**: Understand the brand, audience, and design requirements.
30
-
31
- ### Actions
32
-
33
- 1. Gather brand information from the user:
34
-
35
- ```
36
- BRAND DISCOVERY BRIEF
37
- =====================
38
-
39
- Project Name: [Name]
40
- Tagline/Slogan: [If any]
41
-
42
- 1. BRAND PERSONALITY
43
- - What 3-5 adjectives describe your brand?
44
- Examples: Modern, Playful, Professional, Minimal, Bold, Elegant
45
- - Adjectives: [Answer]
46
-
47
- 2. TARGET AUDIENCE
48
- - Who is your primary audience?
49
- - Age range: [Answer]
50
- - Industry: [Answer]
51
- - Technical level: [Answer]
52
-
53
- 3. COMPETITORS
54
- - List 2-3 competitors or brands you admire:
55
- 1. [Brand] - What you like: [Answer]
56
- 2. [Brand] - What you like: [Answer]
57
- 3. [Brand] - What you like: [Answer]
58
-
59
- 4. STYLE PREFERENCES
60
- - Preferred style? (select all that apply)
61
- [ ] Minimal / Clean
62
- [ ] Geometric / Abstract
63
- [ ] Illustrative / Detailed
64
- [ ] Typographic / Wordmark
65
- [ ] Mascot / Character
66
- [ ] Vintage / Retro
67
- [ ] Futuristic / Tech
68
-
69
- 5. COLOR PREFERENCES
70
- - Any must-have colors? [Answer]
71
- - Any colors to avoid? [Answer]
72
- - Mood: [Warm / Cool / Neutral / Vibrant]
73
-
74
- 6. USAGE CONTEXT
75
- - Where will the logo be used? (select all)
76
- [ ] Website / Web app
77
- [ ] Mobile app
78
- [ ] Social media
79
- [ ] Print materials
80
- [ ] Merchandise
81
- [ ] CLI / Terminal
82
- [ ] npm / Package registry
83
-
84
- 7. EXISTING ASSETS
85
- - Do you have existing brand elements? [Yes/No]
86
- - If yes, what to keep? [Answer]
87
- ```
88
-
89
- 2. Research competitor logos and industry visual trends
90
- 3. Document findings in brand brief
91
-
92
- ### Output
93
-
94
- Brand Discovery Brief document saved to `docs/logo/brand-brief.md`
95
-
96
- ### Gate
97
-
98
- - [ ] Brand personality defined (3-5 adjectives)
99
- - [ ] Target audience identified
100
- - [ ] Style preferences selected
101
- - [ ] Color preferences noted
102
- - [ ] Usage context listed
103
-
104
- ---
105
-
106
- ## Phase 2: CONCEPT
107
-
108
- **Goal**: Generate 3 distinct logo concepts with rationale.
109
-
110
- ### Actions
111
-
112
- 1. Based on the Brand Brief, create 3 logo concepts
113
- 2. Each concept must include:
114
- - Concept name and theme
115
- - ASCII/text representation of the logo idea
116
- - Design rationale (why this works for the brand)
117
- - Mood and feel description
118
-
119
- 3. Present concepts using this template:
120
-
121
- ```
122
- LOGO CONCEPTS
123
- =============
124
-
125
- CONCEPT A: [Name]
126
- ─────────────────
127
- Theme: [Theme description]
128
-
129
- Visual:
130
- ┌──────────────────────────────┐
131
- │ │
132
- │ [ASCII representation] │
133
- │ │
134
- └──────────────────────────────┘
135
-
136
- Description:
137
- - Icon: [What the icon represents]
138
- - Typography: [Font style suggestion]
139
- - Style: [Geometric/Organic/Minimal/etc.]
140
-
141
- Rationale:
142
- [Why this concept fits the brand personality and audience]
143
-
144
- Variants:
145
- - Full logo (icon + text)
146
- - Icon only (for small sizes)
147
- - Text only (wordmark)
148
-
149
- ───────────────────────────────
150
-
151
- CONCEPT B: [Name]
152
- ─────────────────
153
- [Same structure as above]
154
-
155
- ───────────────────────────────
156
-
157
- CONCEPT C: [Name]
158
- ─────────────────
159
- [Same structure as above]
160
-
161
- ───────────────────────────────
162
-
163
- RECOMMENDATION: Concept [X] because [reason]
164
- ```
165
-
166
- 4. Ask user to select preferred concept or provide feedback
167
-
168
- ### Output
169
-
170
- 3 concept presentations with rationale
171
-
172
- ### Gate
173
-
174
- - [ ] 3 distinct concepts created
175
- - [ ] Each has visual representation
176
- - [ ] Each has clear rationale
177
- - [ ] User selected preferred concept
178
-
179
- ### Feedback Loop
180
-
181
- If user wants changes → Refine concepts → Re-present
182
-
183
- ---
184
-
185
- ## Phase 3: DESIGN
186
-
187
- **Goal**: Develop the selected concept into a full design specification.
188
-
189
- ### Actions
190
-
191
- 1. Define the complete color palette:
192
-
193
- ```
194
- COLOR PALETTE
195
- =============
196
-
197
- Primary Colors:
198
- ┌────────────────────────────────────────────────┐
199
- │ [HEX] [Name] - [Usage description] │
200
- │ [HEX] [Name] - [Usage description] │
201
- └────────────────────────────────────────────────┘
202
-
203
- Secondary Colors:
204
- ┌────────────────────────────────────────────────┐
205
- │ [HEX] [Name] - [Usage description] │
206
- │ [HEX] [Name] - [Usage description] │
207
- └────────────────────────────────────────────────┘
208
-
209
- Neutral Colors:
210
- ┌────────────────────────────────────────────────┐
211
- │ [HEX] [Name] - [Usage description] │
212
- │ [HEX] [Name] - [Usage description] │
213
- │ [HEX] [Name] - [Usage description] │
214
- └────────────────────────────────────────────────┘
215
-
216
- Gradients:
217
- - Primary: [HEX] → [HEX] (direction)
218
- - Accent: [HEX] → [HEX] (direction)
219
-
220
- Accessibility:
221
- - Contrast ratio (text on bg): [ratio] (WCAG AA: 4.5:1)
222
- - Contrast ratio (large text): [ratio] (WCAG AA: 3:1)
223
- ```
224
-
225
- 2. Define typography:
226
-
227
- ```
228
- TYPOGRAPHY
229
- ==========
230
-
231
- Logo Font: [Font Name] [Weight]
232
- Heading Font: [Font Name] [Weight]
233
- Body Font: [Font Name] [Weight]
234
- Code/Mono Font: [Font Name] [Weight]
235
-
236
- Font Pairing Rationale: [Why these fonts work together]
237
-
238
- Fallback Stack:
239
- - Headings: [Font], [Fallback1], [Fallback2], sans-serif
240
- - Body: [Font], [Fallback1], [Fallback2], sans-serif
241
- - Code: [Font], [Fallback1], monospace
242
- ```
243
-
244
- 3. Define logo construction and spacing:
245
-
246
- ```
247
- LOGO CONSTRUCTION
248
- =================
249
-
250
- Clear Space:
251
- - Minimum clear space = [X] times the height of the icon
252
- - No other elements should enter the clear space
253
-
254
- Minimum Sizes:
255
- - Digital: [X]px width minimum
256
- - Print: [X]mm width minimum
257
-
258
- Logo Versions:
259
- 1. Full Logo (horizontal) - Icon + Wordmark
260
- 2. Full Logo (stacked) - Icon above Wordmark
261
- 3. Icon Only - For small spaces, favicons
262
- 4. Wordmark Only - Text-only version
263
-
264
- Color Versions:
265
- 1. Full color (on light background)
266
- 2. Full color (on dark background)
267
- 3. Single color (black)
268
- 4. Single color (white/reversed)
269
- ```
270
-
271
- ### Output
272
-
273
- Complete design specification document
274
-
275
- ### Gate
276
-
277
- - [ ] Color palette defined with hex values
278
- - [ ] Typography selected with rationale
279
- - [ ] Logo construction rules defined
280
- - [ ] All logo versions specified
281
- - [ ] Accessibility checked
282
-
283
- ---
284
-
285
- ## Phase 4: REFINE
286
-
287
- **Goal**: Iterate on the design based on user feedback and create usage guidelines.
288
-
289
- ### Actions
290
-
291
- 1. Present complete design spec to user
292
- 2. Gather feedback and iterate
293
- 3. Create Do's and Don'ts:
294
-
295
- ```
296
- LOGO USAGE GUIDELINES
297
- =====================
298
-
299
- DO:
300
- ✓ Use the logo with adequate clear space
301
- ✓ Use approved color versions only
302
- ✓ Maintain aspect ratio when scaling
303
- ✓ Use on backgrounds with sufficient contrast
304
-
305
- DON'T:
306
- ✗ Stretch or distort the logo
307
- ✗ Change the logo colors
308
- ✗ Add effects (shadows, gradients, outlines)
309
- ✗ Place on busy/low-contrast backgrounds
310
- ✗ Rotate the logo
311
- ✗ Rearrange logo elements
312
- ```
313
-
314
- 4. Define social media sizing:
315
-
316
- ```
317
- SOCIAL MEDIA SIZES
318
- ==================
319
-
320
- | Platform | Type | Size (px) |
321
- |-----------|----------------|--------------|
322
- | GitHub | Avatar | 500x500 |
323
- | GitHub | Social Preview | 1280x640 |
324
- | npm | Package Icon | 256x256 |
325
- | X/Twitter | Profile | 400x400 |
326
- | X/Twitter | Header | 1500x500 |
327
- | LinkedIn | Logo | 300x300 |
328
- | LinkedIn | Banner | 1128x191 |
329
- | YouTube | Profile | 800x800 |
330
- | YouTube | Banner | 2560x1440 |
331
- | Instagram | Profile | 320x320 |
332
- | Favicon | Browser Tab | 32x32 |
333
- | PWA Icon | App Icon | 512x512 |
334
- ```
335
-
336
- ### Output
337
-
338
- Refined design with usage guidelines
339
-
340
- ### Gate
341
-
342
- - [ ] User approved final design
343
- - [ ] Do's and Don'ts documented
344
- - [ ] Social media sizes specified
345
- - [ ] All feedback addressed
346
-
347
- ### Feedback Loop
348
-
349
- If user wants more changes → Return to relevant section → Re-present
350
-
351
- ---
352
-
353
- ## Phase 5: DELIVER
354
-
355
- **Goal**: Create the final brand guidelines document and asset list.
356
-
357
- ### Actions
358
-
359
- 1. Compile everything into a Brand Guidelines document:
360
-
361
- ```
362
- BRAND GUIDELINES
363
- ================
364
-
365
- 1. Brand Overview
366
- - Mission / Vision
367
- - Brand Personality
368
- - Tagline
369
-
370
- 2. Logo
371
- - Primary Logo
372
- - Logo Versions
373
- - Construction & Clear Space
374
- - Minimum Sizes
375
- - Do's and Don'ts
376
-
377
- 3. Color Palette
378
- - Primary Colors
379
- - Secondary Colors
380
- - Neutral Colors
381
- - Gradients
382
- - Accessibility Notes
383
-
384
- 4. Typography
385
- - Font Families
386
- - Font Pairing
387
- - Usage Hierarchy
388
-
389
- 5. Applications
390
- - Website
391
- - Social Media
392
- - Documentation
393
- - CLI / Terminal
394
- - Print Materials
395
-
396
- 6. Asset Checklist
397
- - [ ] logo-full.svg (vector)
398
- - [ ] logo-icon.svg (vector)
399
- - [ ] logo-full-light.png (1200x400)
400
- - [ ] logo-full-dark.png (1200x400)
401
- - [ ] logo-icon-512.png (512x512)
402
- - [ ] logo-icon-256.png (256x256)
403
- - [ ] favicon.ico (32x32)
404
- - [ ] social-preview.png (1280x640)
405
- - [ ] brand-guidelines.pdf
406
- ```
407
-
408
- 2. Save brand guidelines to `docs/logo/brand-guidelines.md`
409
- 3. Create implementation notes for developers:
410
-
411
- ```
412
- DEVELOPER IMPLEMENTATION
413
- ========================
414
-
415
- CSS Variables:
416
- --color-primary: [HEX];
417
- --color-secondary: [HEX];
418
- --color-accent: [HEX];
419
- --color-bg-light: [HEX];
420
- --color-bg-dark: [HEX];
421
- --color-text: [HEX];
422
- --font-heading: '[Font]', sans-serif;
423
- --font-body: '[Font]', sans-serif;
424
- --font-mono: '[Font]', monospace;
425
-
426
- Tailwind Config (if applicable):
427
- colors: {
428
- primary: '[HEX]',
429
- secondary: '[HEX]',
430
- accent: '[HEX]',
431
- }
432
- ```
433
-
434
- ### Output
435
-
436
- - `docs/logo/brand-brief.md` - Discovery brief
437
- - `docs/logo/brand-guidelines.md` - Full brand guidelines
438
- - `docs/logo/implementation.md` - Developer implementation notes
439
-
440
- ### Gate
441
-
442
- - [ ] Brand guidelines document complete
443
- - [ ] All assets listed with specifications
444
- - [ ] Developer implementation notes created
445
- - [ ] User approved final deliverables
446
-
447
- ---
448
-
449
- ## Quick Reference
450
-
451
- ### Phase Summary
452
-
453
- | Phase | Goal | Key Output |
454
- |-------|------|------------|
455
- | DISCOVER | Understand the brand | Brand Brief |
456
- | CONCEPT | Generate 3 ideas | 3 Logo Concepts |
457
- | DESIGN | Full design spec | Color, Typography, Construction |
458
- | REFINE | Iterate & guidelines | Usage Guidelines |
459
- | DELIVER | Final documentation | Brand Guidelines |
460
-
461
- ### Success Criteria
462
-
463
- - [ ] Brand discovery completed with user input
464
- - [ ] 3 distinct logo concepts presented
465
- - [ ] User selected and approved final concept
466
- - [ ] Complete color palette with hex values
467
- - [ ] Typography system defined
468
- - [ ] Logo construction rules documented
469
- - [ ] Usage Do's and Don'ts created
470
- - [ ] Social media sizes specified
471
- - [ ] Brand guidelines document delivered
472
- - [ ] Developer implementation notes provided
473
-
474
- ---
475
-
476
- ## Related Skills
477
-
478
- | When | Use |
479
- |------|-----|
480
- | Full marketing plan (logo + content + video) | `/marketing` |
481
- | Write content using the new brand | `/docs:content` |
482
- | Create video using the brand | `/docs:video` |
483
- | Document the brand guidelines | `/docs:write` |
484
-
485
- ## Recommended Agents
486
-
487
- | Phase | Agent | Purpose |
488
- |-------|-------|---------|
489
- | DISCOVER | `@docs-writer` | Document brand brief |
490
- | CONCEPT | `@clean-architect` | Structure the design system |
491
- | DESIGN | `@docs-writer` | Specification documents |
492
- | DELIVER | `@docs-writer` | Brand guidelines document |