opencodekit 0.15.21 → 0.16.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 (116) hide show
  1. package/dist/index.js +5 -7
  2. package/dist/template/.opencode/AGENTS.md +21 -20
  3. package/dist/template/.opencode/agent/build.md +88 -7
  4. package/dist/template/.opencode/agent/explore.md +1 -1
  5. package/dist/template/.opencode/agent/general.md +54 -4
  6. package/dist/template/.opencode/agent/looker.md +1 -1
  7. package/dist/template/.opencode/agent/painter.md +1 -1
  8. package/dist/template/.opencode/agent/plan.md +52 -0
  9. package/dist/template/.opencode/agent/review.md +1 -1
  10. package/dist/template/.opencode/agent/scout.md +3 -3
  11. package/dist/template/.opencode/agent/vision.md +1 -1
  12. package/dist/template/.opencode/command/create.md +201 -95
  13. package/dist/template/.opencode/command/design.md +5 -7
  14. package/dist/template/.opencode/command/handoff.md +7 -0
  15. package/dist/template/.opencode/command/init.md +25 -47
  16. package/dist/template/.opencode/command/plan.md +35 -16
  17. package/dist/template/.opencode/command/resume.md +7 -18
  18. package/dist/template/.opencode/command/ship.md +156 -0
  19. package/dist/template/.opencode/command/start.md +315 -28
  20. package/dist/template/.opencode/command/ui-review.md +5 -7
  21. package/dist/template/.opencode/command/verify.md +279 -0
  22. package/dist/template/.opencode/memory/_templates/README.md +57 -19
  23. package/dist/template/.opencode/memory/_templates/prd.md +29 -0
  24. package/dist/template/.opencode/memory/_templates/project/tech-stack.md +50 -0
  25. package/dist/template/.opencode/memory/_templates/proposal.md +38 -0
  26. package/dist/template/.opencode/memory/_templates/spec.md +66 -0
  27. package/dist/template/.opencode/memory/_templates/tasks.md +198 -0
  28. package/dist/template/.opencode/memory/observations/2026-02-01-decision-add-skills-vs-commands-to-global-agents-.md +15 -0
  29. package/dist/template/.opencode/memory/observations/2026-02-01-decision-build-agent-auto-loads-skills-contextual.md +31 -0
  30. package/dist/template/.opencode/memory/observations/2026-02-01-decision-fixed-agent-configuration-for-opencodeki.md +25 -0
  31. package/dist/template/.opencode/memory/observations/2026-02-01-decision-focused-agents-md-upgrade-for-opencode-k.md +14 -0
  32. package/dist/template/.opencode/memory/observations/2026-02-01-decision-implement-tier-1-permission-upgrades.md +15 -0
  33. package/dist/template/.opencode/memory/observations/2026-02-01-decision-instructions-config-explicit-paths-not-w.md +40 -0
  34. package/dist/template/.opencode/memory/observations/2026-02-01-decision-merged-context-into-memory-project-singl.md +42 -0
  35. package/dist/template/.opencode/memory/observations/2026-02-01-decision-oracle-tool-should-use-review-agent-not-.md +14 -0
  36. package/dist/template/.opencode/memory/observations/2026-02-01-decision-plan-agent-auto-loads-skills-contextuall.md +31 -0
  37. package/dist/template/.opencode/memory/observations/2026-02-01-decision-plan-phased-oracle-command-merge-into-ne.md +14 -0
  38. package/dist/template/.opencode/memory/observations/2026-02-01-decision-prd-workflow-uses-prd-and-prd-task-skill.md +23 -0
  39. package/dist/template/.opencode/memory/observations/2026-02-01-decision-prefer-review-agent-via-opencode-cli-ove.md +14 -0
  40. package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-add-ship-command-with.md +14 -0
  41. package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-and-add-ship-command-.md +14 -0
  42. package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-and-add-ship-command.md +14 -0
  43. package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-skills-vs-commands-section-from-a.md +14 -0
  44. package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-oracle-tool-with-ship-command-fl.md +14 -0
  45. package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-oracle-with-ship-command-workflo.md +14 -0
  46. package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-proxypal-oracle-with-cli-review-.md +14 -0
  47. package/dist/template/.opencode/memory/observations/2026-02-01-decision-simplified-dist-template-only-tech-stack.md +50 -0
  48. package/dist/template/.opencode/memory/observations/2026-02-01-decision-simplified-templates-only-tech-stack-md.md +26 -0
  49. package/dist/template/.opencode/memory/observations/2026-02-01-decision-subagents-load-minimal-skills-stay-lean.md +29 -0
  50. package/dist/template/.opencode/memory/observations/2026-02-01-decision-user-approved-permission-upgrades-in-ope.md +15 -0
  51. package/dist/template/.opencode/memory/observations/2026-02-01-discovery-verify-command-already-implemented.md +28 -0
  52. package/dist/template/.opencode/memory/observations/2026-02-01-feature-openspec-phase-b-complete-template-upgra.md +43 -0
  53. package/dist/template/.opencode/memory/observations/2026-02-01-learning-build-agent-should-use-dynamic-lsp-not-f.md +14 -0
  54. package/dist/template/.opencode/memory/observations/2026-02-01-learning-kimi-k2-5-model-requires-temperature-1-0.md +22 -0
  55. package/dist/template/.opencode/memory/observations/2026-02-01-learning-opencode-context-injection-already-imple.md +27 -0
  56. package/dist/template/.opencode/memory/observations/2026-02-01-learning-opencode-context-injection-uses-instruct.md +35 -0
  57. package/dist/template/.opencode/memory/observations/2026-02-01-learning-update-build-agent-prompt-to-use-context.md +14 -0
  58. package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-using-opencode-expert-.md +14 -0
  59. package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-with-opencode-expert-g.md +14 -0
  60. package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-with-opencode-expert-r.md +14 -0
  61. package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-prefers-copilot-gpt-5-2-codex-mediu.md +14 -0
  62. package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-wants-general-agent-prompt-contextu.md +15 -0
  63. package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-wants-general-agent-prompt-reviewed.md +15 -0
  64. package/dist/template/.opencode/memory/project/command-rules.md +122 -0
  65. package/dist/template/.opencode/memory/project/tech-stack.md +50 -0
  66. package/dist/template/.opencode/memory/research/ccpm-analysis.md +334 -0
  67. package/dist/template/.opencode/memory/research/openspec-analysis.md +226 -0
  68. package/dist/template/.opencode/opencode.json +916 -803
  69. package/dist/template/.opencode/skill/tool-priority/SKILL.md +2 -2
  70. package/package.json +1 -1
  71. package/dist/template/.opencode/command/accessibility-check.md +0 -331
  72. package/dist/template/.opencode/command/agent-browser.md +0 -21
  73. package/dist/template/.opencode/command/analyze-mockup.md +0 -423
  74. package/dist/template/.opencode/command/analyze-project.md +0 -295
  75. package/dist/template/.opencode/command/brainstorm.md +0 -373
  76. package/dist/template/.opencode/command/cloudflare.md +0 -70
  77. package/dist/template/.opencode/command/commit.md +0 -245
  78. package/dist/template/.opencode/command/complete-next-task.md +0 -77
  79. package/dist/template/.opencode/command/design-audit.md +0 -480
  80. package/dist/template/.opencode/command/edit-image.md +0 -242
  81. package/dist/template/.opencode/command/finish.md +0 -255
  82. package/dist/template/.opencode/command/fix-ci.md +0 -109
  83. package/dist/template/.opencode/command/fix-types.md +0 -104
  84. package/dist/template/.opencode/command/fix-ui.md +0 -117
  85. package/dist/template/.opencode/command/fix.md +0 -168
  86. package/dist/template/.opencode/command/frontend-design.md +0 -21
  87. package/dist/template/.opencode/command/generate-diagram.md +0 -349
  88. package/dist/template/.opencode/command/generate-icon.md +0 -283
  89. package/dist/template/.opencode/command/generate-image.md +0 -246
  90. package/dist/template/.opencode/command/generate-pattern.md +0 -247
  91. package/dist/template/.opencode/command/generate-storyboard.md +0 -250
  92. package/dist/template/.opencode/command/implement.md +0 -609
  93. package/dist/template/.opencode/command/import-plan.md +0 -406
  94. package/dist/template/.opencode/command/index-knowledge.md +0 -25
  95. package/dist/template/.opencode/command/integration-test.md +0 -424
  96. package/dist/template/.opencode/command/issue.md +0 -102
  97. package/dist/template/.opencode/command/new-feature.md +0 -651
  98. package/dist/template/.opencode/command/opensrc.md +0 -58
  99. package/dist/template/.opencode/command/quick-build.md +0 -238
  100. package/dist/template/.opencode/command/ralph.md +0 -41
  101. package/dist/template/.opencode/command/research-and-implement.md +0 -148
  102. package/dist/template/.opencode/command/research-ui.md +0 -466
  103. package/dist/template/.opencode/command/restore-image.md +0 -424
  104. package/dist/template/.opencode/command/revert-feature.md +0 -386
  105. package/dist/template/.opencode/command/skill-create.md +0 -517
  106. package/dist/template/.opencode/command/skill-optimize.md +0 -556
  107. package/dist/template/.opencode/command/summarize.md +0 -412
  108. package/dist/template/.opencode/command/triage.md +0 -398
  109. package/dist/template/.opencode/memory/_templates/project/architecture.md +0 -60
  110. package/dist/template/.opencode/memory/_templates/project/commands.md +0 -72
  111. package/dist/template/.opencode/memory/_templates/project/conventions.md +0 -68
  112. package/dist/template/.opencode/memory/_templates/project/gotchas.md +0 -41
  113. package/dist/template/.opencode/skill/notebooklm/SKILL.md +0 -272
  114. package/dist/template/.opencode/skill/notebooklm/references/setup.md +0 -353
  115. package/dist/template/.opencode/tool/notebooklm.ts +0 -488
  116. package/dist/template/.opencode/tool/oracle.ts +0 -240
@@ -1,247 +0,0 @@
1
- ---
2
- description: Generate seamless patterns and textures
3
- argument-hint: "<description> [--type=<type>] [--style=<style>] [--colors=<palette>] [--density=<level>] [--size=<px>]"
4
- agent: painter
5
- ---
6
-
7
- # Generate Pattern: $ARGUMENTS
8
-
9
- Generate seamless, tileable patterns and textures.
10
-
11
- ## Parse Arguments
12
-
13
- | Argument | Default | Options |
14
- | --------------- | --------- | ------------------------------------- |
15
- | Description | required | What the pattern depicts |
16
- | `--type` | geometric | geometric, organic, abstract, texture |
17
- | `--style` | none | See style presets below |
18
- | `--colors` | auto | Hex colors or preset name |
19
- | `--density` | medium | sparse, medium, dense |
20
- | `--size` | 512 | 256, 512, 1024, 2048 |
21
- | `--repeat` | tile | tile, mirror, half-drop, brick |
22
- | `--format` | png | png, svg, both |
23
- | `--transparent` | false | Transparent background |
24
-
25
- ---
26
-
27
- ## Pattern Types
28
-
29
- | Type | Description | Best For |
30
- | ----------- | ----------------------------------------------- | ----------------------------- |
31
- | `geometric` | Shapes, grids, lines, polygons | Modern UI, tech, corporate |
32
- | `organic` | Nature-inspired, flowing, irregular | Wellness, eco, natural brands |
33
- | `abstract` | Artistic, experimental, non-representational | Creative, bold designs |
34
- | `texture` | Material surfaces (wood, marble, fabric, paper) | Backgrounds, realism |
35
-
36
- ---
37
-
38
- ## Style Presets
39
-
40
- | Style | Description | Characteristics |
41
- | -------------- | ------------------------------ | ----------------------------------- |
42
- | `art-deco` | 1920s geometric elegance | Gold, black, symmetry, fan shapes |
43
- | `memphis` | 1980s bold & playful | Bright colors, squiggles, dots |
44
- | `scandinavian` | Nordic minimalism | Muted colors, simple shapes, nature |
45
- | `japanese` | Traditional Japanese motifs | Waves, clouds, cherry blossoms |
46
- | `moroccan` | Islamic geometric patterns | Intricate tiles, symmetry |
47
- | `terrazzo` | Speckled stone aggregate | Colorful chips on neutral base |
48
- | `botanical` | Plant and floral elements | Leaves, flowers, vines |
49
- | `retro` | Mid-century modern | Atomic age, boomerangs, starbursts |
50
- | `tribal` | Ethnic and indigenous patterns | Bold lines, earth tones |
51
- | `digital` | Tech/circuit inspired | Lines, nodes, grid patterns |
52
- | `watercolor` | Soft, painterly texture | Bleeding edges, wash effects |
53
- | `noise` | Grain and static textures | Film grain, static, subtle texture |
54
-
55
- ---
56
-
57
- ## Color Palette Presets
58
-
59
- Use `--colors=<preset>` or specify hex values:
60
-
61
- | Preset | Colors | Mood |
62
- | --------- | ------------------------- | --------------------- |
63
- | `mono` | Single color + variations | Clean, minimal |
64
- | `duotone` | Two contrasting colors | Bold, striking |
65
- | `earth` | Browns, greens, tans | Natural, organic |
66
- | `ocean` | Blues, teals, white | Calm, professional |
67
- | `sunset` | Orange, pink, purple | Warm, vibrant |
68
- | `forest` | Greens, browns, gold | Earthy, grounded |
69
- | `pastel` | Soft, muted colors | Gentle, friendly |
70
- | `neon` | Bright, saturated colors | Energetic, bold |
71
- | `neutral` | Grays, beige, white | Sophisticated, subtle |
72
- | `jewel` | Deep, rich colors | Luxurious, premium |
73
-
74
- **Custom colors:**
75
-
76
- ```bash
77
- --colors=#FF5722,#4CAF50,#2196F3
78
- ```
79
-
80
- ---
81
-
82
- ## Density Levels
83
-
84
- | Density | Description | Use Case |
85
- | -------- | --------------------------- | ---------------------------- |
86
- | `sparse` | Few elements, lots of space | Subtle backgrounds, overlays |
87
- | `medium` | Balanced coverage | General purpose |
88
- | `dense` | Tightly packed elements | Bold statements, textures |
89
-
90
- ---
91
-
92
- ## Repeat Modes
93
-
94
- | Mode | Description | Visual |
95
- | ----------- | ------------------------- | ---------------- |
96
- | `tile` | Direct repeat in grid | ▢▢▢ / ▢▢▢ / ▢▢▢ |
97
- | `mirror` | Flip alternating tiles | ▢◻▢ / ◻▢◻ / ▢◻▢ |
98
- | `half-drop` | Offset by half vertically | ▢▢▢ / ·▢▢ / ▢▢▢ |
99
- | `brick` | Offset like brickwork | ▢▢▢ / ·▢▢▢ / ▢▢▢ |
100
-
101
- ---
102
-
103
- ## Use Cases
104
-
105
- ### UI Backgrounds
106
-
107
- ```bash
108
- # Subtle hero background
109
- /generate-pattern soft gradient noise --type=texture --density=sparse --colors=neutral --transparent
110
-
111
- # Card pattern overlay
112
- /generate-pattern geometric grid --style=digital --density=sparse --colors=#0066CC --transparent
113
- ```
114
-
115
- ### Print & Packaging
116
-
117
- ```bash
118
- # Gift wrap
119
- /generate-pattern festive geometric shapes --style=memphis --colors=pastel --size=2048
120
-
121
- # Fabric print
122
- /generate-pattern botanical leaves --style=scandinavian --colors=forest --repeat=half-drop
123
- ```
124
-
125
- ### Branding
126
-
127
- ```bash
128
- # Corporate pattern
129
- /generate-pattern subtle diagonal lines --type=geometric --colors=#1a1a1a --density=sparse
130
-
131
- # Playful brand pattern
132
- /generate-pattern abstract shapes and dots --style=memphis --colors=neon
133
- ```
134
-
135
- ### Textures
136
-
137
- ```bash
138
- # Paper texture
139
- /generate-pattern subtle paper grain --type=texture --colors=#FAFAFA --density=medium
140
-
141
- # Marble surface
142
- /generate-pattern marble veins --type=texture --colors=#FFFFFF,#CCCCCC,#999999 --size=1024
143
-
144
- # Wood grain
145
- /generate-pattern oak wood grain --type=texture --colors=earth
146
- ```
147
-
148
- ---
149
-
150
- ## Examples by Style
151
-
152
- ```bash
153
- # Art Deco
154
- /generate-pattern fan shapes and gold lines --style=art-deco --colors=#1a1a1a,#D4AF37
155
-
156
- # Japanese
157
- /generate-pattern waves and clouds --style=japanese --colors=ocean
158
-
159
- # Terrazzo
160
- /generate-pattern colorful stone chips --style=terrazzo --colors=pastel --size=1024
161
-
162
- # Moroccan
163
- /generate-pattern intricate tile pattern --style=moroccan --colors=jewel
164
-
165
- # Scandinavian
166
- /generate-pattern simple leaf shapes --style=scandinavian --colors=#2D4739,#F5F5DC
167
- ```
168
-
169
- ---
170
-
171
- ## Output
172
-
173
- ### File Structure
174
-
175
- ```
176
- .opencode/memory/design/patterns/[name]/
177
- ├── pattern-512.png # Main pattern tile
178
- ├── pattern-512.svg # Vector version (if --format=svg)
179
- ├── pattern-preview.png # 3x3 tiled preview
180
- ├── pattern-dark.png # Dark variant (if applicable)
181
- └── usage.css # CSS snippet
182
- ```
183
-
184
- ### CSS Snippet
185
-
186
- ```css
187
- /* Generated pattern usage */
188
- .pattern-background {
189
- background-image: url("pattern-512.png");
190
- background-repeat: repeat;
191
- background-size: 128px 128px; /* Adjust for desired scale */
192
- }
193
-
194
- /* With overlay for text readability */
195
- .pattern-overlay {
196
- background:
197
- linear-gradient(rgba(255, 255, 255, 0.9), rgba(255, 255, 255, 0.9)), url("pattern-512.png");
198
- background-repeat: repeat;
199
- }
200
-
201
- /* CSS-only alternative (if simple enough) */
202
- .pattern-css {
203
- background: repeating-linear-gradient(45deg, #f0f0f0, #f0f0f0 10px, #ffffff 10px, #ffffff 20px);
204
- }
205
- ```
206
-
207
- ---
208
-
209
- ## Requirements
210
-
211
- - **Seamless tiling**: Must repeat perfectly in all directions
212
- - **Edge matching**: No visible seams when tiled
213
- - **Consistent density**: Even distribution across tile
214
- - **Color accuracy**: Match specified palette exactly
215
-
216
- ---
217
-
218
- ## Tips for Better Patterns
219
-
220
- 1. **Be specific**: "Geometric triangles" > "shapes"
221
- 2. **Reference styles**: "Like William Morris wallpaper"
222
- 3. **Specify scale**: "Large-scale floral" vs "micro pattern"
223
- 4. **Consider use**: "For dark text overlay" guides contrast
224
- 5. **Test at scale**: Preview at intended display size
225
-
226
- ---
227
-
228
- ## Limitations
229
-
230
- | Limitation | Workaround |
231
- | ----------------------- | ------------------------------------------- |
232
- | Complex illustrations | Use simpler, repeated motifs |
233
- | Photorealistic textures | Use `--type=texture` with specific material |
234
- | Exact brand assets | Provide reference, use as base |
235
- | Perfect symmetry | May need manual adjustment |
236
- | Text in patterns | Add text in post-processing |
237
-
238
- ---
239
-
240
- ## Related Commands
241
-
242
- | Need | Command |
243
- | -------------- | ----------------- |
244
- | Generate image | `/generate-image` |
245
- | Edit pattern | `/edit-image` |
246
- | Create icon | `/generate-icon` |
247
- | Analyze design | `/analyze-mockup` |
@@ -1,250 +0,0 @@
1
- ---
2
- description: Generate sequential images for visual storytelling
3
- argument-hint: "<story-description> [--frames=<N>] [--style=<style>] [--aspect=<ratio>] [--layout=<layout>]"
4
- agent: painter
5
- ---
6
-
7
- # Generate Storyboard: $ARGUMENTS
8
-
9
- Generate a sequence of images telling a visual story with consistent characters and settings.
10
-
11
- ## Parse Arguments
12
-
13
- | Argument | Default | Options |
14
- | ----------------- | -------- | -------------------------------- |
15
- | Story description | required | Narrative or script to visualize |
16
- | `--frames` | 4 | 3-12 frames |
17
- | `--style` | sketch | See style presets below |
18
- | `--aspect` | 16:9 | 16:9, 4:3, 1:1, 9:16 |
19
- | `--layout` | grid | grid, strip, single |
20
- | `--captions` | true | Include scene descriptions |
21
- | `--timing` | false | Add duration annotations |
22
-
23
- ---
24
-
25
- ## Style Presets
26
-
27
- | Style | Description | Best For |
28
- | ------------ | ----------------------------------------- | ---------------------------------- |
29
- | `sketch` | Hand-drawn, rough lines, quick | Pre-production, drafts |
30
- | `comic` | Bold lines, panels, dynamic | Marketing, entertainment |
31
- | `realistic` | Photo-realistic rendering | Film pre-viz, client presentations |
32
- | `animation` | Clean lines, flat colors | Animated content planning |
33
- | `noir` | High contrast, shadows, dramatic | Thriller, drama |
34
- | `watercolor` | Soft, artistic, painterly | Emotional narratives |
35
- | `minimalist` | Simple shapes, icons | UX flows, explainers |
36
- | `cinematic` | Widescreen, film grain, dramatic lighting | Video production |
37
- | `children` | Bright colors, friendly, rounded | Kids content |
38
- | `technical` | Clean, annotated, precise | Product demos, tutorials |
39
-
40
- ---
41
-
42
- ## Aspect Ratios
43
-
44
- | Ratio | Dimensions | Use Case |
45
- | -------- | ----------- | -------------------------------- |
46
- | `16:9` | Widescreen | Video, YouTube, presentations |
47
- | `4:3` | Traditional | Classic film, some presentations |
48
- | `1:1` | Square | Social media, Instagram |
49
- | `9:16` | Vertical | TikTok, Stories, Reels |
50
- | `2.35:1` | Anamorphic | Cinematic widescreen |
51
-
52
- ---
53
-
54
- ## Shot Types
55
-
56
- Specify shot types in your description for precise framing:
57
-
58
- | Shot | Description | Emotional Effect |
59
- | ------------------- | ------------------------------------ | --------------------------- |
60
- | `wide/establishing` | Full environment, tiny figures | Context, scale, isolation |
61
- | `medium` | Waist up, some environment | Conversation, action |
62
- | `close-up` | Face or object fills frame | Emotion, detail, importance |
63
- | `extreme close-up` | Eyes, hands, small detail | Intensity, intimacy |
64
- | `over-shoulder` | Behind one character, facing another | Dialogue, connection |
65
- | `bird's eye` | Directly above | Overview, vulnerability |
66
- | `low angle` | Looking up at subject | Power, dominance |
67
- | `high angle` | Looking down at subject | Weakness, submission |
68
- | `POV` | Character's viewpoint | Immersion, subjectivity |
69
-
70
- **Example prompt with shots:**
71
-
72
- ```
73
- Frame 1: Wide shot - City skyline at sunset, small figure on rooftop
74
- Frame 2: Medium shot - Character turns, looking worried
75
- Frame 3: Close-up - Phone screen showing message
76
- Frame 4: Over-shoulder - Character reading, city blurred behind
77
- ```
78
-
79
- ---
80
-
81
- ## Panel Layouts
82
-
83
- | Layout | Description | Frames |
84
- | ---------- | -------------------------- | ------------------- |
85
- | `grid` | Even grid arrangement | Any (auto-arranges) |
86
- | `strip` | Single horizontal row | 3-6 frames |
87
- | `vertical` | Single vertical column | 3-6 frames |
88
- | `featured` | One large + smaller panels | 4-6 frames |
89
- | `single` | Individual images only | Any |
90
-
91
- ---
92
-
93
- ## Use Cases
94
-
95
- ### Video Production
96
-
97
- ```bash
98
- # Commercial storyboard
99
- /generate-storyboard Product unboxing: hands open box, reveal product, show features, happy customer using it --frames=6 --style=cinematic --aspect=16:9
100
-
101
- # Music video
102
- /generate-storyboard Singer in empty warehouse, dancing, memories flash, reunites with loved one --frames=8 --style=noir --timing
103
- ```
104
-
105
- ### UX/Product Flows
106
-
107
- ```bash
108
- # User journey
109
- /generate-storyboard User discovers app, signs up, completes first task, shares achievement --frames=4 --style=minimalist --aspect=1:1
110
-
111
- # Feature explainer
112
- /generate-storyboard Problem: messy desk. Solution: our app. Result: organized life --frames=3 --style=technical
113
- ```
114
-
115
- ### Marketing/Social
116
-
117
- ```bash
118
- # Social campaign
119
- /generate-storyboard Day in the life with our coffee: morning routine, commute, work meeting, evening relaxation --frames=4 --style=watercolor --aspect=9:16
120
-
121
- # Brand story
122
- /generate-storyboard Founder's journey: garage startup, first customer, team growth, today's success --frames=6 --style=sketch
123
- ```
124
-
125
- ### Animation Planning
126
-
127
- ```bash
128
- # Character animation
129
- /generate-storyboard Character walks in, sees something surprising, reacts with joy, celebrates --frames=4 --style=animation
130
-
131
- # Explainer video
132
- /generate-storyboard Complex data enters system, gets processed, outputs simple insights --frames=5 --style=minimalist
133
- ```
134
-
135
- ---
136
-
137
- ## Maintaining Consistency
138
-
139
- ### Character Consistency
140
-
141
- Include character details in your prompt:
142
-
143
- ```
144
- Main character: Young woman, short black hair, red jacket, determined expression
145
- Setting: Rainy city at night, neon signs, wet streets
146
- ```
147
-
148
- ### Consistency Tips
149
-
150
- 1. **Define characters first**: Age, hair, clothing, distinguishing features
151
- 2. **Establish setting**: Time of day, weather, key environmental elements
152
- 3. **Maintain color palette**: Specify dominant colors to carry through
153
- 4. **Reference previous frames**: "Same character from frame 1..."
154
- 5. **Use consistent lighting**: Define light source direction
155
-
156
- ---
157
-
158
- ## Transitions & Timing
159
-
160
- Use `--timing` to add duration annotations:
161
-
162
- | Transition | Symbol | Description |
163
- | ---------- | ------ | -------------------- | --------------- |
164
- | Cut | `→` | Instant switch |
165
- | Fade | `~>` | Gradual transition |
166
- | Dissolve | `<~>` | Blend between frames |
167
- | Wipe | ` | >` | Edge transition |
168
-
169
- **Example output with timing:**
170
-
171
- ```
172
- Frame 1 (3s) → Frame 2 (2s) ~> Frame 3 (4s) → Frame 4 (2s)
173
- ```
174
-
175
- ---
176
-
177
- ## Captions & Dialogue
178
-
179
- Include dialogue or narration:
180
-
181
- ```bash
182
- /generate-storyboard Scene: coffee shop meeting
183
- Frame 1: "Two old friends spot each other" - wide shot, recognition
184
- Frame 2: "They haven't seen each other in years" - medium, approaching
185
- Frame 3: "Warm embrace" - close-up, emotional hug
186
- Frame 4: "Just like old times" - sitting, laughing, coffee cups
187
- ```
188
-
189
- ---
190
-
191
- ## Output
192
-
193
- ### File Structure
194
-
195
- ```
196
- .opencode/memory/design/storyboards/[story-name]/
197
- ├── frames/
198
- │ ├── 01-establishing.png
199
- │ ├── 02-introduction.png
200
- │ ├── 03-conflict.png
201
- │ └── 04-resolution.png
202
- ├── storyboard-sheet.png # Combined layout
203
- ├── storyboard-sheet.pdf # Print-ready
204
- └── script.md # Scene descriptions + timing
205
- ```
206
-
207
- ### Script Output
208
-
209
- ```markdown
210
- # Storyboard: [Story Name]
211
-
212
- ## Frame 1 - Establishing Shot
213
-
214
- **Duration:** 3 seconds
215
- **Shot:** Wide
216
- **Description:** City skyline at sunset, small figure visible on rooftop
217
- **Audio:** Ambient city sounds, distant traffic
218
- **Transition:** Cut to →
219
-
220
- ## Frame 2 - Introduction
221
-
222
- **Duration:** 2 seconds
223
- **Shot:** Medium
224
- **Description:** Character turns, worried expression
225
- **Dialogue:** (thinking) "Where is she?"
226
- **Transition:** Fade to ~>
227
- ```
228
-
229
- ---
230
-
231
- ## Limitations
232
-
233
- | Limitation | Workaround |
234
- | ----------------------------- | ---------------------------------------------------------- |
235
- | Perfect character consistency | Include detailed character description; may need touch-ups |
236
- | Exact pose matching | Describe poses clearly; use reference terms |
237
- | Complex action sequences | Break into more frames |
238
- | Text/dialogue in image | Add text in post-processing |
239
- | Specific brand elements | Describe style, add logos later |
240
-
241
- ---
242
-
243
- ## Related Commands
244
-
245
- | Need | Command |
246
- | --------------------- | ------------------- |
247
- | Generate single image | `/generate-image` |
248
- | Edit a frame | `/edit-image` |
249
- | Create diagram | `/generate-diagram` |
250
- | Analyze reference | `/analyze-mockup` |