moicle 1.2.0 → 1.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.
@@ -0,0 +1,651 @@
1
+ ---
2
+ name: video-content
3
+ description: Plan and produce video content strategy including scripts, storyboards, and production specs. Use when user says "create video", "video content", "video script", "video strategy", "youtube content", "video plan".
4
+ ---
5
+
6
+ # Video Content Skill
7
+
8
+ Structured workflow for planning video content — from strategy and scripting to production specs and publishing schedule.
9
+
10
+ ## Workflow Overview
11
+
12
+ ```
13
+ STRATEGY → SCRIPT → STORYBOARD → PRODUCTION → PUBLISH
14
+ │ │ │ │ │
15
+ ▼ ▼ ▼ ▼ ▼
16
+ Define Write Visual Tech Calendar
17
+ Series Scripts Flow & Specs & & Platform
18
+ & Goals & Hooks Scenes Checklist Distribution
19
+ ```
20
+
21
+ ## Recommended Agents
22
+
23
+ | Phase | Agent | Purpose |
24
+ |-------|-------|---------|
25
+ | STRATEGY | @docs-writer | Document content strategy |
26
+ | SCRIPT | @docs-writer | Write scripts and outlines |
27
+ | STORYBOARD | @docs-writer | Scene descriptions |
28
+ | PRODUCTION | @devops | Technical setup specs |
29
+ | PUBLISH | @docs-writer | Publishing calendar |
30
+
31
+ ---
32
+
33
+ ## Phase 1: STRATEGY
34
+
35
+ **Goal**: Define video content strategy, target audience, and series plan.
36
+
37
+ ### Actions
38
+
39
+ 1. Gather video strategy requirements from the user:
40
+
41
+ ```
42
+ VIDEO CONTENT STRATEGY BRIEF
43
+ =============================
44
+
45
+ 1. PURPOSE
46
+ - What is the goal of your video content?
47
+ [ ] Brand Awareness
48
+ [ ] Product Education / Tutorials
49
+ [ ] Community Building
50
+ [ ] Lead Generation / Conversion
51
+ [ ] Thought Leadership
52
+ - Primary goal: [Answer]
53
+
54
+ 2. TARGET AUDIENCE
55
+ - Who will watch these videos?
56
+ - Audience: [Answer]
57
+ - Technical level: [Beginner / Intermediate / Advanced / Mixed]
58
+ - Preferred language: [Answer]
59
+
60
+ 3. PRODUCT / TOPIC
61
+ - What product or topic are videos about?
62
+ - Product: [Answer]
63
+ - Key features to highlight: [Answer]
64
+ - Unique selling points: [Answer]
65
+
66
+ 4. PLATFORMS
67
+ - Where will videos be published? (select all)
68
+ [ ] YouTube (long-form)
69
+ [ ] YouTube Shorts
70
+ [ ] TikTok
71
+ [ ] Instagram Reels
72
+ [ ] LinkedIn
73
+ [ ] X (Twitter)
74
+ [ ] Website / Blog
75
+ [ ] Dev.to / Hashnode
76
+
77
+ 5. RESOURCES
78
+ - Available equipment:
79
+ [ ] Screen recording software
80
+ [ ] Webcam / Camera
81
+ [ ] Microphone
82
+ [ ] Video editing software
83
+ [ ] Animation tools
84
+ - Budget: [Answer]
85
+ - Team size: [Answer]
86
+
87
+ 6. COMPETITORS / INSPIRATION
88
+ - Channels or creators you admire:
89
+ 1. [Channel] - What you like: [Answer]
90
+ 2. [Channel] - What you like: [Answer]
91
+ - Style preference: [Casual / Professional / Mix]
92
+ ```
93
+
94
+ 2. Define video series:
95
+
96
+ ```
97
+ VIDEO SERIES PLAN
98
+ =================
99
+
100
+ Series 1: [Name] — [Type: Awareness / Education / Conversion]
101
+ ├── Format: [Screen recording / Face cam / Animation / Mix]
102
+ ├── Duration: [Length per video]
103
+ ├── Frequency: [How often]
104
+ ├── Platform: [Primary platform]
105
+ ├── Episodes planned: [Number]
106
+ └── Videos:
107
+ ├── EP01: [Title] — [Brief description]
108
+ ├── EP02: [Title] — [Brief description]
109
+ ├── EP03: [Title] — [Brief description]
110
+ ├── EP04: [Title] — [Brief description]
111
+ └── EP05: [Title] — [Brief description]
112
+
113
+ Series 2: [Name] — [Type]
114
+ ├── Format: [Format]
115
+ ├── Duration: [Length]
116
+ ├── Frequency: [How often]
117
+ ├── Platform: [Primary]
118
+ ├── Episodes planned: [Number]
119
+ └── Videos:
120
+ ├── EP01: [Title] — [Brief description]
121
+ ├── EP02: [Title] — [Brief description]
122
+ └── EP03: [Title] — [Brief description]
123
+
124
+ Series 3: [Name] — [Type: Shorts / Reels]
125
+ ├── Format: [Format]
126
+ ├── Duration: [15-60s]
127
+ ├── Frequency: [How often]
128
+ ├── Platform: [TikTok / Reels / Shorts]
129
+ ├── Episodes planned: [Number]
130
+ └── Videos:
131
+ ├── EP01: [Title] — [Brief description]
132
+ ├── EP02: [Title] — [Brief description]
133
+ └── EP03: [Title] — [Brief description]
134
+ ```
135
+
136
+ ### Output
137
+
138
+ - Video Content Strategy Brief
139
+ - Video Series Plan with episode list
140
+
141
+ ### Gate
142
+
143
+ - [ ] Purpose and goals defined
144
+ - [ ] Target audience identified
145
+ - [ ] Platforms selected
146
+ - [ ] At least 2 video series planned
147
+ - [ ] Episode list for each series created
148
+
149
+ ---
150
+
151
+ ## Phase 2: SCRIPT
152
+
153
+ **Goal**: Write detailed scripts for each video.
154
+
155
+ ### Actions
156
+
157
+ 1. For each video, create a script using this template:
158
+
159
+ ```
160
+ VIDEO SCRIPT
161
+ ============
162
+
163
+ Title: [Video Title]
164
+ Series: [Series Name]
165
+ Episode: [Number]
166
+ Duration: [Target length]
167
+ Platform: [Primary platform]
168
+ Type: [Tutorial / Demo / Comparison / Tips / Story]
169
+
170
+ ─────────────────────────────────────────
171
+
172
+ HOOK (0:00 - 0:10)
173
+ Goal: Grab attention in first 3 seconds
174
+
175
+ [Visual]: [What appears on screen]
176
+ [Audio]: "[Exact words to say]"
177
+
178
+ Hook Type: [Choose one]
179
+ - Problem statement: "Are you tired of...?"
180
+ - Bold claim: "This will change how you..."
181
+ - Question: "Did you know...?"
182
+ - Demo tease: "Watch what happens when..."
183
+
184
+ ─────────────────────────────────────────
185
+
186
+ INTRO (0:10 - 0:30)
187
+ Goal: Set context and promise value
188
+
189
+ [Visual]: [What appears on screen]
190
+ [Audio]: "[Exact words to say]"
191
+
192
+ Key points to cover:
193
+ - What this video is about
194
+ - What viewer will learn/see
195
+ - Why they should keep watching
196
+
197
+ ─────────────────────────────────────────
198
+
199
+ MAIN CONTENT
200
+
201
+ Section 1: [Section Title] (0:30 - X:XX)
202
+
203
+ [Visual]: [What appears on screen]
204
+ [Action]: [What to demonstrate]
205
+ [Audio]: "[Narration/explanation]"
206
+
207
+ Key Points:
208
+ - [Point 1]
209
+ - [Point 2]
210
+
211
+ Commands/Code to show:
212
+ ```
213
+ [code or commands]
214
+ ```
215
+
216
+ Section 2: [Section Title] (X:XX - X:XX)
217
+
218
+ [Visual]: [What appears on screen]
219
+ [Action]: [What to demonstrate]
220
+ [Audio]: "[Narration/explanation]"
221
+
222
+ Key Points:
223
+ - [Point 1]
224
+ - [Point 2]
225
+
226
+ [Continue for each section...]
227
+
228
+ ─────────────────────────────────────────
229
+
230
+ CONCLUSION (Last 15-30s)
231
+ Goal: Summarize and call to action
232
+
233
+ [Visual]: [What appears on screen]
234
+ [Audio]: "[Exact words to say]"
235
+
236
+ Summary points:
237
+ - [Key takeaway 1]
238
+ - [Key takeaway 2]
239
+
240
+ Call to Action:
241
+ - Primary CTA: [Subscribe / Try product / Visit link]
242
+ - Secondary CTA: [Comment / Share / Next video]
243
+
244
+ ─────────────────────────────────────────
245
+
246
+ METADATA
247
+
248
+ Title (SEO): [YouTube/platform title, max 60 chars]
249
+ Description: [2-3 sentence description]
250
+ Tags/Keywords: [tag1, tag2, tag3, tag4, tag5]
251
+ Thumbnail Concept: [What the thumbnail should show]
252
+ End Screen: [What to link to]
253
+ ```
254
+
255
+ 2. For short-form videos (Shorts/Reels/TikTok), use condensed format:
256
+
257
+ ```
258
+ SHORT VIDEO SCRIPT
259
+ ==================
260
+
261
+ Title: [Title]
262
+ Duration: [15-60s]
263
+ Platform: [TikTok / Reels / Shorts]
264
+ Format: [Vertical 9:16]
265
+
266
+ [0:00-0:03] HOOK
267
+ [Visual]: [What appears]
268
+ [Text overlay]: "[On-screen text]"
269
+ [Audio]: "[Words or music]"
270
+
271
+ [0:03-0:XX] CONTENT
272
+ [Visual]: [What appears]
273
+ [Text overlay]: "[On-screen text]"
274
+ [Audio]: "[Words or narration]"
275
+
276
+ [0:XX-0:XX] PAYOFF
277
+ [Visual]: [Result/revelation]
278
+ [Text overlay]: "[Final text]"
279
+ [Audio]: "[Closing words]"
280
+
281
+ [End] CTA
282
+ [Text overlay]: "Follow for more" / "[CTA text]"
283
+
284
+ Caption: [Platform caption with hashtags]
285
+ Hashtags: #tag1 #tag2 #tag3 #tag4 #tag5
286
+ Sound: [Original / Trending sound name]
287
+ ```
288
+
289
+ ### Output
290
+
291
+ Complete scripts for all planned videos
292
+
293
+ ### Gate
294
+
295
+ - [ ] Each video has a complete script
296
+ - [ ] Hooks are compelling (first 3 seconds)
297
+ - [ ] Clear structure with timestamps
298
+ - [ ] CTAs included in every video
299
+ - [ ] SEO metadata defined
300
+
301
+ ---
302
+
303
+ ## Phase 3: STORYBOARD
304
+
305
+ **Goal**: Create visual flow and scene descriptions for each video.
306
+
307
+ ### Actions
308
+
309
+ 1. For each video, create a storyboard:
310
+
311
+ ```
312
+ STORYBOARD
313
+ ==========
314
+
315
+ Video: [Title]
316
+
317
+ Scene 1: [Scene Name]
318
+ ┌─────────────────────────────┐
319
+ │ Timestamp: 0:00 - 0:10 │
320
+ │ │
321
+ │ Visual: [Description of │
322
+ │ what appears on screen] │
323
+ │ │
324
+ │ Text Overlay: [Any text] │
325
+ │ Transition: [Cut/Fade/Zoom] │
326
+ │ Audio: [Narration/Music] │
327
+ └─────────────────────────────┘
328
+
329
+
330
+ Scene 2: [Scene Name]
331
+ ┌─────────────────────────────┐
332
+ │ Timestamp: 0:10 - 0:30 │
333
+ │ │
334
+ │ Visual: [Description] │
335
+ │ │
336
+ │ Text Overlay: [Any text] │
337
+ │ Transition: [Type] │
338
+ │ Audio: [Narration/Music] │
339
+ └─────────────────────────────┘
340
+
341
+
342
+ [Continue for all scenes...]
343
+ ```
344
+
345
+ 2. Define visual style guide for the series:
346
+
347
+ ```
348
+ VIDEO VISUAL STYLE GUIDE
349
+ ========================
350
+
351
+ Screen Recording:
352
+ - Terminal theme: [Dark / Light / Custom]
353
+ - Terminal font size: [18-20px recommended]
354
+ - Browser: [Chrome / Firefox / etc.]
355
+ - Window arrangement: [Full screen / Split]
356
+ - Cursor highlight: [Yes / No]
357
+
358
+ Overlays & Graphics:
359
+ - Lower third: [Style description]
360
+ - Text overlays: [Font, Color, Position]
361
+ - Code highlights: [How to emphasize code]
362
+ - Arrow/pointer annotations: [Style]
363
+
364
+ Transitions:
365
+ - Between sections: [Cut / Crossfade / Zoom]
366
+ - Duration: [0.3s - 0.5s standard]
367
+
368
+ Intro Template:
369
+ - Duration: [3-5 seconds]
370
+ - Elements: [Logo animation + title]
371
+
372
+ Outro Template:
373
+ - Duration: [5-10 seconds]
374
+ - Elements: [Subscribe CTA + next video]
375
+
376
+ Thumbnail Template:
377
+ - Style: [Bold text + screenshot + face]
378
+ - Colors: [Brand colors]
379
+ - Font: [Bold, readable at small size]
380
+ - Layout: [Left text, right visual]
381
+ ```
382
+
383
+ ### Output
384
+
385
+ - Storyboard for each video
386
+ - Video visual style guide
387
+
388
+ ### Gate
389
+
390
+ - [ ] All videos have scene-by-scene storyboards
391
+ - [ ] Visual style guide defined
392
+ - [ ] Transitions specified
393
+ - [ ] Overlay/graphic templates described
394
+ - [ ] Thumbnail template defined
395
+
396
+ ---
397
+
398
+ ## Phase 4: PRODUCTION
399
+
400
+ **Goal**: Define technical specs and create production checklist.
401
+
402
+ ### Actions
403
+
404
+ 1. Define production specifications:
405
+
406
+ ```
407
+ PRODUCTION SPECS
408
+ ================
409
+
410
+ Video Formats:
411
+ ┌────────────────────────────────────────────────┐
412
+ │ Platform │ Resolution │ Ratio │ FPS │
413
+ ├───────────────┼────────────┼───────┼───────────┤
414
+ │ YouTube │ 1920x1080 │ 16:9 │ 60fps │
415
+ │ YouTube Short │ 1080x1920 │ 9:16 │ 30fps │
416
+ │ TikTok │ 1080x1920 │ 9:16 │ 30fps │
417
+ │ Instagram │ 1080x1920 │ 9:16 │ 30fps │
418
+ │ LinkedIn │ 1920x1080 │ 16:9 │ 30fps │
419
+ │ X/Twitter │ 1920x1080 │ 16:9 │ 30fps │
420
+ └────────────────────────────────────────────────┘
421
+
422
+ Audio:
423
+ - Format: AAC / WAV
424
+ - Sample rate: 48kHz
425
+ - Bitrate: 320kbps
426
+ - Noise reduction: Yes
427
+ - Music volume: -20dB under voice
428
+
429
+ Export Settings:
430
+ - Codec: H.264 / H.265
431
+ - Bitrate: 8-12 Mbps (1080p)
432
+ - Audio: AAC 320kbps
433
+ - Container: MP4
434
+ ```
435
+
436
+ 2. Create production checklist:
437
+
438
+ ```
439
+ PRE-PRODUCTION CHECKLIST
440
+ ========================
441
+
442
+ Before Recording:
443
+ - [ ] Script finalized and reviewed
444
+ - [ ] Storyboard ready
445
+ - [ ] Software/tools installed and configured
446
+ - [ ] Terminal theme set up (dark, font size 18+)
447
+ - [ ] Demo project/code prepared
448
+ - [ ] Test recording (audio + video quality)
449
+ - [ ] Close unnecessary apps and notifications
450
+ - [ ] Clear desktop/browser bookmarks bar
451
+
452
+ Recording:
453
+ - [ ] Screen recording started (correct resolution)
454
+ - [ ] Audio recording started (check levels)
455
+ - [ ] Face cam positioned (if applicable)
456
+ - [ ] Follow script scene by scene
457
+ - [ ] Pause between sections (for editing)
458
+ - [ ] Record each demo 2x (for best take)
459
+
460
+ Post-Production:
461
+ - [ ] Import footage into editor
462
+ - [ ] Rough cut (remove mistakes, pauses)
463
+ - [ ] Add intro/outro
464
+ - [ ] Add text overlays and annotations
465
+ - [ ] Add background music
466
+ - [ ] Color correction (if face cam)
467
+ - [ ] Add subtitles (Vietnamese + English)
468
+ - [ ] Export in correct format per platform
469
+ - [ ] Create thumbnail
470
+ - [ ] Write title, description, tags
471
+
472
+ Quality Check:
473
+ - [ ] Watch full video at 1x speed
474
+ - [ ] Audio clear and balanced
475
+ - [ ] Text readable on mobile
476
+ - [ ] No sensitive info visible (passwords, tokens)
477
+ - [ ] Subtitles accurate
478
+ - [ ] Links and CTAs correct
479
+ ```
480
+
481
+ 3. Recommend tools:
482
+
483
+ ```
484
+ RECOMMENDED TOOLS
485
+ =================
486
+
487
+ Recording:
488
+ - OBS Studio (free) - Screen recording
489
+ - Asciinema - Terminal recording
490
+ - QuickTime (Mac) - Simple screen capture
491
+
492
+ Editing:
493
+ - DaVinci Resolve (free) - Professional editing
494
+ - CapCut (free) - Quick edits, shorts
495
+ - FFmpeg (free) - CLI video processing
496
+
497
+ Audio:
498
+ - Audacity (free) - Audio editing
499
+ - Noise reduction plugins
500
+
501
+ Graphics:
502
+ - Figma (free) - Thumbnails, overlays
503
+ - Canva (free) - Quick graphics
504
+
505
+ Subtitles:
506
+ - YouTube auto-captions + manual edit
507
+ - Subtitle Edit (free)
508
+
509
+ Music:
510
+ - YouTube Audio Library (free, royalty-free)
511
+ - Pixabay Music (free)
512
+ ```
513
+
514
+ ### Output
515
+
516
+ - Production specifications document
517
+ - Pre/post production checklists
518
+ - Tools recommendation
519
+
520
+ ### Gate
521
+
522
+ - [ ] Technical specs defined per platform
523
+ - [ ] Production checklist created
524
+ - [ ] Tools identified and recommended
525
+ - [ ] Quality check process documented
526
+
527
+ ---
528
+
529
+ ## Phase 5: PUBLISH
530
+
531
+ **Goal**: Create publishing calendar and distribution plan.
532
+
533
+ ### Actions
534
+
535
+ 1. Create content calendar:
536
+
537
+ ```
538
+ CONTENT CALENDAR — [Month/Year]
539
+ ================================
540
+
541
+ WEEK 1: [Theme]
542
+ ├── Mon: [Platform] — [Video Title] (Series: [Name])
543
+ ├── Tue: [Platform] — [Video Title]
544
+ ├── Wed: [Platform] — [Short Title] x3
545
+ ├── Thu: [Platform] — [Video Title]
546
+ └── Fri: [Platform] — [Short Title]
547
+
548
+ WEEK 2: [Theme]
549
+ ├── Mon: [Platform] — [Video Title]
550
+ ├── Tue: [Platform] — [Video Title]
551
+ ├── Wed: [Platform] — [Short Title] x3
552
+ ├── Thu: [Platform] — [Video Title]
553
+ └── Fri: [Platform] — [Short Title]
554
+
555
+ WEEK 3: [Theme]
556
+ [Continue pattern...]
557
+
558
+ WEEK 4: [Theme]
559
+ [Continue pattern...]
560
+
561
+ ────────────────────────────────────
562
+
563
+ POSTING SCHEDULE:
564
+ - YouTube long-form: [Day(s)], [Time] [Timezone]
565
+ - YouTube Shorts: [Day(s)], [Time]
566
+ - TikTok: [Day(s)], [Time]
567
+ - Instagram Reels: [Day(s)], [Time]
568
+ - LinkedIn: [Day(s)], [Time]
569
+ - X/Twitter: [Day(s)], [Time]
570
+ ```
571
+
572
+ 2. Define cross-posting strategy:
573
+
574
+ ```
575
+ CROSS-POSTING STRATEGY
576
+ ======================
577
+
578
+ One Video → Multiple Platforms:
579
+
580
+ Long-form Tutorial (8-12 min)
581
+ ├── YouTube: Full video
582
+ ├── Blog: Written tutorial version
583
+ ├── X/Twitter: Key moment GIF + link
584
+ ├── LinkedIn: Summary post + link
585
+ └── Clips: 3-5 short clips for Shorts/Reels/TikTok
586
+
587
+ Short Demo (30-60s)
588
+ ├── YouTube Shorts: Vertical version
589
+ ├── TikTok: With trending sound
590
+ ├── Instagram Reels: With caption
591
+ ├── X/Twitter: Direct upload
592
+ └── LinkedIn: Professional angle
593
+ ```
594
+
595
+ 3. Define KPIs and tracking:
596
+
597
+ ```
598
+ VIDEO KPIs
599
+ ==========
600
+
601
+ | Metric | Target (Monthly) | Tool |
602
+ |---------------------|-------------------|----------------|
603
+ | Total views | [Target] | Platform native |
604
+ | Watch time (hours) | [Target] | YouTube Studio |
605
+ | Subscriber growth | [Target] | YouTube Studio |
606
+ | Engagement rate | [Target]% | Platform native |
607
+ | Click-through rate | [Target]% | YouTube Studio |
608
+ | Shorts views | [Target] | YouTube Studio |
609
+ | TikTok followers | [Target] | TikTok Analytics|
610
+ | Website traffic | [Target] | Google Analytics|
611
+ ```
612
+
613
+ ### Output
614
+
615
+ - Monthly content calendar
616
+ - Cross-posting strategy
617
+ - KPI tracking sheet
618
+
619
+ ### Gate
620
+
621
+ - [ ] Monthly calendar created
622
+ - [ ] Posting schedule with times and platforms
623
+ - [ ] Cross-posting strategy defined
624
+ - [ ] KPIs and targets set
625
+ - [ ] User approved the publishing plan
626
+
627
+ ---
628
+
629
+ ## Quick Reference
630
+
631
+ ### Phase Summary
632
+
633
+ | Phase | Goal | Key Output |
634
+ |-------|------|------------|
635
+ | STRATEGY | Define goals & series | Content Strategy Brief |
636
+ | SCRIPT | Write video scripts | Complete scripts with hooks |
637
+ | STORYBOARD | Visual scene planning | Scene-by-scene flow |
638
+ | PRODUCTION | Tech specs & checklists | Production-ready specs |
639
+ | PUBLISH | Calendar & distribution | Publishing schedule |
640
+
641
+ ### Success Criteria
642
+
643
+ - [ ] Video strategy aligned with business goals
644
+ - [ ] At least 2 video series planned
645
+ - [ ] Scripts written with compelling hooks
646
+ - [ ] Storyboards with visual flow
647
+ - [ ] Production specs per platform
648
+ - [ ] Quality checklist followed
649
+ - [ ] Publishing calendar created
650
+ - [ ] Cross-posting strategy defined
651
+ - [ ] KPIs set and tracking plan ready
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "moicle",
3
- "version": "1.2.0",
3
+ "version": "1.3.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",