heraspec 0.1.16 → 0.1.17

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.
@@ -7,5 +7,6 @@ export declare class CreateCommand {
7
7
  }): Promise<void>;
8
8
  private scaffoldPerfexModule;
9
9
  private scaffoldWordPressPlugin;
10
+ private scaffoldContentChannel;
10
11
  }
11
12
  //# sourceMappingURL=create.d.ts.map
@@ -8,7 +8,7 @@ export declare const ARCHIVES_DIR_NAME = "archives";
8
8
  export declare const SKILLS_DIR_NAME = "skills";
9
9
  export declare const KNOWLEDGE_DIR_NAME = "knowledge";
10
10
  export declare const MEMORY_DIR_NAME = "memory";
11
- export declare const PROJECT_TYPES: readonly ["wordpress-plugin", "wordpress-theme", "perfex-module", "laravel-package", "node-service", "generic-webapp", "backend-api", "frontend-app", "multi-stack"];
11
+ export declare const PROJECT_TYPES: readonly ["wordpress-plugin", "wordpress-theme", "perfex-module", "laravel-package", "node-service", "generic-webapp", "backend-api", "frontend-app", "multi-stack", "content-channel"];
12
12
  export type ProjectType = (typeof PROJECT_TYPES)[number];
13
13
  export declare const SKILLS: Record<ProjectType, string[]>;
14
14
  export type Skill = typeof SKILLS[ProjectType][number];
@@ -71,6 +71,10 @@ export declare class InitCommand {
71
71
  * Prompt user to bootstrap memory if historical specs are found
72
72
  */
73
73
  private checkAndBootstrapMemory;
74
+ /**
75
+ * Automatically install content-channel skills if project type is content-channel
76
+ */
77
+ private checkAndBootstrapContentChannel;
74
78
  /**
75
79
  * Get the knowledge source directory from CLI package
76
80
  */
@@ -12,6 +12,7 @@ export declare const ProjectTypeSchema: z.ZodEnum<{
12
12
  "backend-api": "backend-api";
13
13
  "frontend-app": "frontend-app";
14
14
  "multi-stack": "multi-stack";
15
+ "content-channel": "content-channel";
15
16
  }>;
16
17
  export declare const SpecMetaSchema: z.ZodOptional<z.ZodObject<{
17
18
  projectType: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
@@ -24,6 +25,7 @@ export declare const SpecMetaSchema: z.ZodOptional<z.ZodObject<{
24
25
  "backend-api": "backend-api";
25
26
  "frontend-app": "frontend-app";
26
27
  "multi-stack": "multi-stack";
28
+ "content-channel": "content-channel";
27
29
  }>, z.ZodArray<z.ZodEnum<{
28
30
  "wordpress-plugin": "wordpress-plugin";
29
31
  "wordpress-theme": "wordpress-theme";
@@ -34,6 +36,7 @@ export declare const SpecMetaSchema: z.ZodOptional<z.ZodObject<{
34
36
  "backend-api": "backend-api";
35
37
  "frontend-app": "frontend-app";
36
38
  "multi-stack": "multi-stack";
39
+ "content-channel": "content-channel";
37
40
  }>>]>>;
38
41
  domain: z.ZodOptional<z.ZodString>;
39
42
  stack: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
@@ -15,6 +15,7 @@ export declare const SpecSchema: z.ZodObject<{
15
15
  "backend-api": "backend-api";
16
16
  "frontend-app": "frontend-app";
17
17
  "multi-stack": "multi-stack";
18
+ "content-channel": "content-channel";
18
19
  }>, z.ZodArray<z.ZodEnum<{
19
20
  "wordpress-plugin": "wordpress-plugin";
20
21
  "wordpress-theme": "wordpress-theme";
@@ -25,6 +26,7 @@ export declare const SpecSchema: z.ZodObject<{
25
26
  "backend-api": "backend-api";
26
27
  "frontend-app": "frontend-app";
27
28
  "multi-stack": "multi-stack";
29
+ "content-channel": "content-channel";
28
30
  }>>]>>;
29
31
  domain: z.ZodOptional<z.ZodString>;
30
32
  stack: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
@@ -0,0 +1,83 @@
1
+ ---
2
+ name: content-compliance
3
+ description: Legal compliance, platform policy alignment, and mandatory disclaimer integration under Vietnamese Decree 15/2020/ND-CP and Meta/YouTube/TikTok Community Standards.
4
+ projectType: content-channel
5
+ ---
6
+
7
+ # Skill: Content Compliance
8
+
9
+ ## Purpose
10
+ Ensure all content scripts, video intros, and post captions strictly comply with digital content regulations (Vietnamese Decree 15/2020/ND-CP & Decree 14/2022/ND-CP) and social platform safety policies, preventing penalties, algorithmic reach suppression, demonetization, or copyright/community strikes.
11
+
12
+ ## When to Use
13
+ - Writing scripts or captions for sensitive niches: Horror/Paranormal, Health/Wellness, Personal Finance/Affiliate, Psychology
14
+ - Generating Intro Warning Cards for video rendering
15
+ - Conducting pre-publishing safety and legal compliance audits
16
+
17
+ ## The 3 Mandatory Disclaimer Placements
18
+
19
+ For sensitive or regulated topics, disclaimers MUST appear in **3 distinct locations**:
20
+
21
+ ```text
22
+ 1. VIDEO INTRO (0:00 - 0:04) --> Intro Warning Card (3-5s black screen with high-contrast text)
23
+ 2. POST CAPTION / FIRST COMMENT --> Dedicated disclaimer block at footer or pinned comment
24
+ 3. SPOKEN VOICEOVER (Audio) --> Spoken disclaimer narration for long-form podcasts (>10 mins)
25
+ ```
26
+
27
+ ---
28
+
29
+ ## 4 Standard Legal Disclaimer Models
30
+
31
+ ### Model 1: Horror, Paranormal & Folklore Fiction (`Truyen-Ma`)
32
+ ```text
33
+ ⚠️ KHUYẾN CÁO PHÁP LÝ & GIẢI TRÍ:
34
+
35
+ Video này là tác phẩm truyện ma - tâm linh hư cấu, được mua tác quyền hợp pháp và sản xuất nhằm mục đích giải trí.
36
+ Mọi tình tiết, nhân vật, địa danh trong câu chuyện đều là giả định, hoàn toàn không phản ánh thực tế và không nhằm mục đích bôi nhọ, xúc phạm bất kỳ cá nhân, tổ chức hay tôn giáo nào.
37
+
38
+ Quan điểm: Kênh tôn trọng pháp luật và các giá trị văn hóa, khoa học. Chúng tôi không truyền bá, không hướng dẫn và không cổ súy cho các hủ tục, bùa ngải hay các hành vi mê tín dị đoan gây ảnh hưởng xấu đến đời sống xã hội.
39
+
40
+ Khuyến cáo người xem: Nội dung có các yếu tố tâm linh - kinh dị, xin vui lòng cân nhắc kỹ trước khi xem.
41
+ ```
42
+
43
+ ### Model 2: Health, Wellness & Herbal Remedies (`Than-An-Tam-Lac`)
44
+ ```text
45
+ 🌿 KHUYẾN CÁO Y KHOA & SỨC KHỎE:
46
+
47
+ Các bài viết, động tác dưỡng sinh và mẹo chăm sóc sức khỏe trên kênh được đúc kết từ kinh nghiệm thực dưỡng và tài liệu y học thường thức nhằm mục đích tham khảo, nâng cao ý thức chăm sóc cơ thể.
48
+ Nội dung này không thể thay thế cho chẩn đoán, phác đồ điều trị hay chỉ định chuyên khoa từ bác sĩ và chuyên gia y tế có chứng chỉ hành nghề. Người có bệnh lý nền xin vui lòng tham vấn ý kiến bác sĩ trước khi áp dụng.
49
+ ```
50
+
51
+ ### Model 3: Healing, Psychology & Personal Reflection (`Lam-Ban-Voi-Ban-Than`, `An-Tru-Quan`)
52
+ ```text
53
+ 💌 LƯU Ý TÂM LÝ & CHỮA LÀNH:
54
+
55
+ Nội dung bài viết là những dòng tự sự cảm xúc và góc nhìn chiêm nghiệm cá nhân nhằm vỗ về tâm hồn và lan tỏa năng lượng tích cực.
56
+ Kênh không cung cấp các liệu trình tham vấn hoặc trị liệu tâm lý chuyên sâu. Nếu bạn đang trải qua những tổn thương tâm lý trầm trọng hoặc khủng hoảng cảm xúc kéo dài, xin hãy tìm kiếm sự trợ giúp từ các chuyên gia tâm lý hoặc cơ sở y tế uy tín.
57
+ ```
58
+
59
+ ### Model 4: Finance, Investment & Affiliate Marketing
60
+ ```text
61
+ 📊 TUYÊN BỐ MIỄN TRỪ TRÁCH NHIỆM TÀI CHÍNH:
62
+
63
+ Mọi phân tích, chia sẻ về kinh nghiệm kinh doanh, tài chính cá nhân và sản phẩm trên kênh chỉ mang tính chất thông tin và góc nhìn tham khảo, tuyệt đối không cấu thành lời khuyên đầu tư hay cam kết lợi nhuận tài chính. Người xem tự chịu trách nhiệm cho các quyết định đầu tư và mua sắm của mình.
64
+ ```
65
+
66
+ ---
67
+
68
+ ## Pre-Publishing Legal Checklist
69
+ - [ ] Intro Warning Card (0:00 - 0:04) rendered into the video timeline.
70
+ - [ ] Full disclaimer text present in Caption footer or Pinned Top Comment.
71
+ - [ ] Zero real names of temples, pagodas, hospitals, or private entities associated with superstition or defamation (use fictional placeholders: Pagoda T., Hospital K...).
72
+ - [ ] Visuals contain zero graphic gore, mutilated bodies, or prohibited adult imagery.
73
+
74
+ ---
75
+
76
+ ## Universal Activation Prompt Template
77
+
78
+ ```text
79
+ Use skill content-compliance to audit a script and generate disclaimers for niche [Horror / Health / Healing / Finance]:
80
+ - Provide the standardized legal disclaimer text for the Facebook caption footer.
81
+ - Provide the AI image prompt for the Intro Warning Card (0:00 - 0:04, 16:9).
82
+ - Screen all character names and locations in the script to ensure 100% safe fictionalization.
83
+ ```
@@ -0,0 +1,74 @@
1
+ ---
2
+ name: content-prompts
3
+ description: Design and generation of production-ready AI Visual Prompts (Midjourney/Flux/SD) and Suno AI BGM instrumental prompts tailored to each channel's aesthetic identity.
4
+ projectType: content-channel
5
+ ---
6
+
7
+ # Skill: Content Prompts
8
+
9
+ ## Purpose
10
+ Engineer high-aesthetic, cinematic AI visual prompts and evocative background music (BGM) prompts tailored to each channel's artistic tone, narrative pacing, and technical delivery requirements.
11
+
12
+ ## When to Use
13
+ - Generating Avatar (1:1), Channel Cover (16:9), and Warning Card visual prompts
14
+ - Creating scene-by-scene storyboard prompts for episode scripts (`--ar 16:9` or `--ar 9:16`)
15
+ - Crafting Suno AI instrumental prompts with specific style tags, BPM, and instrument combinations
16
+ - Populating the `prompts/` folder of a channel
17
+
18
+ ## Visual Prompt Engineering Standards
19
+
20
+ ### 1. Structure of a High-Impact Visual Prompt
21
+ ```text
22
+ [Core Subject & Action], [Environment & Setting], [Artistic Style & Medium], [Lighting & Color Palette], [Camera Angle & Depth of Field], [Technical Flags: 8k resolution, cinematic, --ar {ratio} --v 6.1]
23
+ ```
24
+
25
+ ### 2. Standard Aspect Ratios
26
+ - **Avatar / Profile Icon**: `--ar 1:1`
27
+ - **Channel Cover / Banner**: `--ar 16:9` (incorporating negative space for typography)
28
+ - **In-stream Video Storyboard (Landscape)**: `--ar 16:9`
29
+ - **Reels / Shorts Storyboard (Portrait)**: `--ar 9:16`
30
+
31
+ ### 3. Channel Style Profiles
32
+
33
+ | Channel | Visual Art Style | Color Palette & Mood |
34
+ | :--- | :--- | :--- |
35
+ | **Truyện Ma Đêm Mưa** | Dark Cinematic, moody shadows, horror folklore, mysterious fog | Deep navy, blood crimson, candlelight, charcoal black |
36
+ | **Làm Bạn Với Bản Thân** | Minimalist soft watercolor illustration, gentle warm atmosphere | Pastel peach, sage green, warm cream, gentle sunlight |
37
+ | **Tĩnh Tâm Quán** | Traditional Zen ink wash painting (thủy mặc), misty mountains, lotus | Monochrome sumi-e ink, bamboo emerald, soft lotus gold |
38
+ | **Góc Chiêm Nghiệm** | Modern urban cinematic, cozy coffee shop, contemplative dusk | Espresso brown, warm amber, muted slate, dusk blue |
39
+ | **Thân An Tâm Lạc** | Organic wellness, herbal aesthetics, mindful living, clean natural light | Matcha green, earthy beige, natural wood, morning sun |
40
+ | **Năm Năm Tháng Tháng** | Vintage nostalgic watercolor / retro film photography, Vietnamese countryside | Sepia warmth, rustic ochre, faded memories, rain reflections |
41
+ | **An Trú Quán** | Minimalist Zen sanctuary, rustic veranda, misty bamboo forest | Emerald green, earthen terracotta, warm bamboo light |
42
+
43
+ ### 4. Mandatory Intro Warning Card Prompt
44
+ For Horror and sensitive topics, provide the standardized prompt:
45
+ > `A minimalist cinematic warning disclaimer screen, pure deep black background, centered bold typography with a subtle elegant yellow-gold warning icon at the top, high contrast clean text layout, cinematic editorial style, 8k, --ar 16:9`
46
+
47
+ ---
48
+
49
+ ## Suno AI Audio BGM Engineering Standards
50
+
51
+ ### BGM Prompt Guidelines
52
+ - **Always specify Instrumental**: `[Instrumental]`
53
+ - **Structure**:
54
+ ```text
55
+ [Genre / Style], [Lead Instruments], [Secondary Textures], [Tempo / BPM], [Mood / Emotion], [Audio Quality / Mixing Tag]
56
+ ```
57
+ - **Examples**:
58
+ - *Horror / Paranormal*: `Dark Ambient, bowed cello, dissonant violin textures, low resonant sub-bass drone, unsettling eerie wind SFX, 60 BPM, cinematic horror, mysterious tense mixing --no vocal`
59
+ - *Healing / Self-Care*: `Warm Lo-fi Acoustic, gentle solo piano melody, warm nylon guitar, soft vinyl crackle, 72 BPM, deeply emotional, healing, comforting, nostalgic --no vocal`
60
+ - *Zen / Mindfulness*: `Zen Meditation, Tibetan singing bowl, serene bamboo flute (shakuhachi), gentle temple wind chimes, flowing stream ambient sound, 55 BPM, peaceful, tranquil, sacred --no vocal`
61
+ - *Wellness*: `Acoustic Wellness, gentle harp arpeggios, soft acoustic guitar, natural birdsong and morning forest ambience, 65 BPM, refreshing, restorative, clean --no vocal`
62
+
63
+ ---
64
+
65
+ ## Universal Activation Prompt Template
66
+
67
+ ```text
68
+ Use skill content-prompts to create visual and music prompts for channel [CHANNEL_NAME]:
69
+ - Requirements:
70
+ 1. Avatar prompt (1:1) and Facebook cover prompt (16:9) matching the channel's art identity.
71
+ 2. A 5-scene storyboard prompt table for episode: "[EPISODE_TITLE]".
72
+ 3. A Suno AI instrumental BGM prompt specifying instruments, tempo (BPM), and mood.
73
+ - Output Language: All visual and audio prompts MUST be in English.
74
+ ```
@@ -0,0 +1,82 @@
1
+ ---
2
+ name: content-scaffolding
3
+ description: Automated scaffolding and initialization for new content channels according to MTxStudio Content Vault 2-level hierarchy standards.
4
+ projectType: content-channel
5
+ ---
6
+
7
+ # Skill: Content Scaffolding
8
+
9
+ ## Purpose
10
+ Automate the directory layout, baseline documentation, prompt templates, and starter post creation for a new channel repository matching the exact MTxStudio Script & Content Vault (v2) schema.
11
+
12
+ ## When to Use
13
+ - Initializing a brand new channel within `Facebook/` or any target workspace
14
+ - Generating standardized 2-level directory trees and metadata
15
+ - Preparing a channel for automated discovery by `export_vault_json.py`
16
+
17
+ ## Universal Inviolable Rules
18
+
19
+ ### 1. Pure Brand Name (Never Prepend [Channel])
20
+ - ❌ **NEVER** prepend `[Channel]`, `[Kênh]`, or `Channel:` to folder names or brand titles.
21
+ - ✅ Always use the pure brand name (e.g., `Làm Bạn Với Bản Thân`, `Thân An Tâm Lạc`, `An Trú Quán`).
22
+ - Rationale: MTxStudio sidebar displays dedicated icons, color badges, and counters. Redundant prefixes degrade UI ergonomics.
23
+
24
+ ### 2. 2-Level Tree Hierarchy & Type Assignments
25
+ Every new channel maps into this category structure:
26
+ ```text
27
+ 📁 [Channel Name] <-- type: "article", parentId: null, icon: Channel Icon
28
+ ├── 📑 Kế hoạch & Định vị <-- type: "docs", parentId: Root, icon: Layers, color: #a855f7
29
+ ├── 📖 Kịch bản & Bài viết <-- type: "article", parentId: Root, icon: BookOpen, color: #10b981
30
+ ├── ✨ Thư viện Prompts Visual <-- type: "prompts", parentId: Root, icon: Sparkles, color: #f59e0b
31
+ ├── 📻 Nhạc Nền <-- type: "music", parentId: Root, icon: Radio, color: #ec4899
32
+ └── 🛍️ Tiếp thị liên kết & Sản phẩm (Optional) <-- type: "docs", parentId: Root, icon: Tag, color: #38bdf8
33
+ ```
34
+
35
+ ## Step-by-Step Execution Workflow
36
+
37
+ ### Step 1: Scaffold Channel Directory Structure
38
+ For a given channel slug (e.g., `An-Tru-Quan`):
39
+ ```text
40
+ Facebook/[Channel-Folder]/
41
+ ├── plan.md
42
+ ├── posts/
43
+ │ ├── README.md
44
+ │ └── 01_Tap_01_Khoi_Dau_Hanh_Trinh.md
45
+ ├── prompts/
46
+ │ ├── avatar_prompts.txt
47
+ │ ├── cover_prompts.txt
48
+ │ ├── scene_broll_prompts.txt
49
+ │ ├── suno_music_prompts.txt
50
+ │ └── huong_dan_su_dung.txt
51
+ └── affiliate/
52
+ ├── README.md
53
+ └── danh_muc_san_pham.md
54
+ ```
55
+
56
+ ### Step 2: Populate Baseline Files
57
+ 1. `plan.md`: Formulated using `content-strategy` standards (persona, 5 pillars, cold start roadmap).
58
+ 2. `posts/01_Tap_01_*.md`: Starter episode adhering to the 6-part schema.
59
+ 3. `prompts/`: Complete set of 5 prompt files covering Avatar (1:1), Cover (16:9), B-roll scenes, Suno BGM, and operational usage guides.
60
+ 4. `affiliate/danh_muc_san_pham.md`: 3-tier catalog (Tier A, Tier B, Tier C).
61
+
62
+ ### Step 3: Vault Auto-Discovery
63
+ The Python export pipeline (`export_vault_json.py`) dynamically discovers any subfolder containing `plan.md`. Manual code registration is no longer required.
64
+
65
+ ### Step 4: Verification Checklist
66
+ - [ ] No `[Channel]` or `[Kênh]` prefix in folder names, slugs, or markdown files.
67
+ - [ ] Posts follow exact section headers for regex parsing.
68
+ - [ ] Prompts are written in English with standard flags (`--ar 1:1`, `--ar 16:9`, `--v 6.0`).
69
+
70
+ ---
71
+
72
+ ## Universal Activation Prompt Template
73
+
74
+ ```text
75
+ Use skill content-scaffolding to scaffold a new channel:
76
+ - Channel Name: [e.g., An Trú Quán]
77
+ - Folder Slug: [e.g., An-Tru-Quan]
78
+ - Slogan: [e.g., Góc bình yên, thiền định và tĩnh tâm]
79
+ - Theme Color: [e.g., #10b981] | Lucide Icon: [e.g., Sparkles]
80
+ - Output Directory: Facebook/An-Tru-Quan
81
+ - Requirements: Strictly follow pure brand naming, create standard 2-level directory tree, starter post, full prompts suite, and affiliate catalog.
82
+ ```
@@ -0,0 +1,147 @@
1
+ ---
2
+ name: content-scripting
3
+ description: Professional scriptwriting for social video & audio content adhering to strict AI Voice Synthesis (TTS) acoustic rules and MTxStudio 6-part schema.
4
+ projectType: content-channel
5
+ ---
6
+
7
+ # Skill: Content Scripting
8
+
9
+ ## Purpose
10
+ Author high-retention video and audio scripts formatted according to MTxStudio's 6-part post schema, strictly optimized for AI Voice Synthesis engines (VieNeu, Vibe-TTS, Edge-TTS, RVC) to prevent voice glitches, audio artifacts, and abrupt breathing drop-offs.
11
+
12
+ ## When to Use
13
+ - Writing individual episode scripts or batch episodes for any channel (`posts/{index}_{slug}.md`)
14
+ - Converting ideas, notes, or story premises into production-ready scripts
15
+ - Auditing existing scripts for TTS acoustic compliance and pacing
16
+
17
+ ## Critical AI Voice Synthesis (TTS) Acoustic Rules
18
+
19
+ ### 1. Sentence Length & Natural Breathing Rhythm
20
+ - **Sentence length**: Strictly **12 to 20 words** (never exceed 25 words or 120 characters).
21
+ - **Clause length (comma separated)**: **8 to 12 words** maximum.
22
+ - **Rule**: Break complex compound sentences into short, punchy sentences with periods `.`. Never chain 3-4 clauses together with repeated conjunctions.
23
+
24
+ ### 2. Repetition Loop Prevention (Anti-Looping)
25
+ - **The Issue**: Autoregressive and Flow-matching TTS models frequently loop or stutter on repetitive phonemes or reduplicative words (*đau đáu, bâng khuâng, run rẩy, chầm chậm, khôn nguôi, da diết, lặng lẽ, rả rích...*).
26
+ - **Rule 1**: ❌ NEVER place two reduplicative words back-to-back.
27
+ - **Rule 2**: ✅ ALWAYS insert a comma `,` before sensitive reduplicative words.
28
+ - *Example*:
29
+ - ❌ *Incorrect*: "nỗi đau đáu khôn nguôi về người mẹ"
30
+ - ✅ *Correct*: "nỗi niềm đau đáu, khôn nguôi về người mẹ"
31
+
32
+ ### 3. Poetry & Rhythmic Verse Rules
33
+ - **Line Break Preservation**: ❌ NEVER merge poetry lines with `join(' ')`. **EVERY verse line must occupy its own individual line (`\n`)** so the TTS engine pauses naturally.
34
+ - Separate stanzas with an empty line (`\n\n`).
35
+ - Use commas `,` and ellipses `...` to create organic breathing pauses.
36
+
37
+ ### 4. Acoustic Expression Tags & MTxStudio 42-Tag Catalog
38
+ MTxStudio features a specialized acoustic expression parser (`expressionCatalog.ts`) supporting **42 standardized expression tags**.
39
+ - **Rule 1 (Strict Whitelist)**: Use ONLY tags from the 42 approved catalog below. ❌ NEVER invent or insert unsupported bracket tags.
40
+ - **Rule 2 (Natural Cadence First)**: Pacing is primarily achieved through sentence length (12-20 words) and punctuation. Use expression tags intentionally for emotional inflection, dramatic pauses, or verse rhythm.
41
+
42
+ | Category | Vietnamese Tag (Recommended) | English Equivalent | Acoustic Purpose |
43
+ | :--- | :--- | :--- | :--- |
44
+ | **Breath & Relaxation** | `[lấy hơi]` | `[inhale]` | Inhale before long sentences or climax |
45
+ | | `[thở dài]` | `[sigh]` | Nostalgic, sorrowful, or weary sigh |
46
+ | | `[thở phào]` | `[relief]` | Sigh of relief after tension passes |
47
+ | | `[thở dốc]` | `[panting]` | Heavy panting after panic or flight |
48
+ | **Laughter & Smiles** | `[cười khẽ]` | `[chuckle]` | Warm, gentle, friendly chuckle |
49
+ | | `[cười nhẹ]` | `[light smile]` | Light pleasant smile in tone |
50
+ | | `[bật cười]` | `[burst laugh]` | Sudden burst of genuine laughter |
51
+ | | `[cười rúc rích]` | `[giggle]` | Playful, mischievous giggle |
52
+ | | `[cười khẩy]` | `[smirk]` | Ironic, skeptical, or smug smirk |
53
+ | | `[cười khoái trá]` | `[wicked laugh]` | Triumphant or wicked laugh |
54
+ | **Tears & Sorrow** | `[thút thít]` | `[whimper]` | Suppressed whimpering or quiet weeping |
55
+ | | `[nức nở]` | `[sobbing]` | Full sobbing breaking speech cadence |
56
+ | | `[bật khóc]` | `[burst into tears]` | Overcome with tears |
57
+ | **Suspense & Drama** | `[thì thầm]` | `[whisper]` | Mysterious or secretive whispering |
58
+ | | `[giọng run]` | `[trembling voice]` | Voice shaking from terror or cold |
59
+ | | `[thở run]` | `[shivering breath]` | Trembling breath in danger |
60
+ | | `[hớp hơi]` | `[gasp]` | Sharp gasp of shock or horror |
61
+ | | `[thét]` | `[scream]` | Piercing scream of panic |
62
+ | | `[quát]` | `[shout]` | Commanding, authoritative shout |
63
+ | | `[gầm gừ]` | `[snarl]` | Throaty growl or angry snarl |
64
+ | **Pacing & Rhythm** | `[ngắt ngắn]` / `[0.3s]` | `[short pause]` | 0.3s - 0.5s pause for natural breath |
65
+ | | `[ngắt dài]` / `[1s]` | `[long pause]` | 1.0s dramatic silence or deep contemplation |
66
+ | | `[nói chậm lại]` | `[slow down]` | Deliberate, measured pace (0.8x) for wisdom/quotes |
67
+ | | `[nói nhanh lên]` | `[speed up]` | Urgent, rapid cadence |
68
+ | | `[nói khẽ]` | `[speak softly]` | Intimate, gentle low volume |
69
+ | | `[nói vang]` | `[speak loudly]` | Resonant, expansive projection |
70
+ | **Biological Cues** | `[nuốt khan]` | `[gulp]` | Nervous dry swallow |
71
+ | | `[hắng giọng]` | `[clear throat]` | Subtle throat clearing |
72
+ | | `[sụt sịt]` | `[sniffle]` | Sniffling from cold or held-back tears |
73
+ | | `[ngập ngừng]` | `[hesitate]` | Hesitant stutter before a difficult word |
74
+
75
+ ### 5. Character Hygiene
76
+ - ❌ **NO en-dash `–` or em-dash `—`**. Use standard hyphen `-`, comma `,`, or colon `:`.
77
+
78
+ ---
79
+
80
+ ## 6-Part Post Schema Standard
81
+
82
+ For Vietnamese content channels, every script file in `posts/` MUST adhere to this exact structural contract so that `export_vault_json.py` can parse it into MTxStudio JSON blocks:
83
+
84
+ ```markdown
85
+ # TẬP [Episode Number]: [EPISODE TITLE IN UPPERCASE]
86
+
87
+ - **Trụ cột nội dung:** [Pillar Name according to plan.md]
88
+ - **Định dạng tối ưu:** [Reels 9:16 / Video In-stream 16:9]
89
+ - **Thời lượng ước tính:** [Estimated Duration, e.g., 55 giây / 3 phút]
90
+ - **Giọng đọc đề xuất:** [Voice Style, e.g., Nam/Nữ trầm ấm, 115-120 từ/phút]
91
+ - **Nhạc nền BGM:** [Music description & volume, e.g., Acoustic Guitar, -24dB]
92
+
93
+ ---
94
+
95
+ ## 1. HOOK MỞ ĐẦU (3 - 5 GIÂY ĐẦU)
96
+ > "[Compelling opening hook addressing pain point, curiosity, or emotional trigger]"
97
+
98
+ ---
99
+
100
+ ## 2. KỊCH BẢN THUYẾT MINH & LỜI THOẠI CHI TIẾT
101
+ ### Khổ 1: [Section Title]
102
+ [Spoken audio narration conforming strictly to TTS acoustic rules, 12-20 words per sentence...]
103
+
104
+ ### Khổ 2: [Section Title]
105
+ [Continuing narrative...]
106
+
107
+ ---
108
+
109
+ ### PHÂN CẢNH VISUAL STORYBOARD
110
+ | Mốc thời gian | Mô tả hình ảnh & Visual B-roll | Prompt AI (Midjourney / Stable Diffusion) |
111
+ | :--- | :--- | :--- |
112
+ | **00:00 - 00:15** | [Visual description in Vietnamese] | `[Cinematic prompt in English with camera angle, lighting, 8k, --ar 16:9]` |
113
+ | **00:15 - 00:45** | [Visual description in Vietnamese] | `[Cinematic prompt in English with camera angle, lighting, 8k, --ar 16:9]` |
114
+
115
+ ---
116
+
117
+ ## 4. CAPTION FACEBOOK BÀI ĐĂNG
118
+ [Engaging hook caption line]
119
+
120
+ [Short summary or key takeaway connecting with audience emotions]
121
+
122
+ [Call to action question encouraging comments]
123
+
124
+ #Hashtag1 #Hashtag2 #Hashtag3 #MTxStudio
125
+
126
+ ---
127
+
128
+ ## 5. SẢN PHẨM AFFILIATE GẮN KÈM
129
+ | Tên Sản Phẩm | Tầng Sản Phẩm | Vị Trí Đặt Link | Câu Lồng Ghép Soft-sell |
130
+ | :--- | :--- | :--- | :--- |
131
+ | [Tên Sản Phẩm] | Tầng A / Tầng B | Pinned Comment | "[Natural soft-sell sentence]" |
132
+ ```
133
+
134
+ ---
135
+
136
+ ## Universal Activation Prompt Template
137
+
138
+ ```text
139
+ Use skill content-scripting to write an episode script:
140
+ - Channel: [e.g., An Trú Quán]
141
+ - Episode: Episode [e.g., 02] - "[e.g., Lắng Nghe Nỗi Buồn Của Chính Mình]"
142
+ - Pillar: [e.g., Pillar 1: Câu chuyện cốt lõi & Chữa lành]
143
+ - Target Format: [e.g., Reels 9:16 (50s) or Video In-stream 16:9 (3 mins)]
144
+ - Output Language: Vietnamese (narration & captions) + English (visual prompts)
145
+ - TTS Requirements: Short sentences (12-20 words), comma clauses (8-12 words), zero artificial bracket tags, proper verse line preservation.
146
+ - Schema: Full 6-part MTxStudio format with Storyboard table and Facebook Caption.
147
+ ```
@@ -0,0 +1,78 @@
1
+ ---
2
+ name: content-strategy
3
+ description: Strategic planning, market positioning, audience persona, 5-pillar content matrix, 14-day cold start roadmap, and $100 RPM monetization model for content channels.
4
+ projectType: content-channel
5
+ ---
6
+
7
+ # Skill: Content Strategy
8
+
9
+ ## Purpose
10
+ Guide AI agents and content creators in market positioning, audience persona definition, 5-pillar content matrix construction, 14-day cold start scheduling, and monetization modeling for new or existing content channels.
11
+
12
+ ## When to Use
13
+ - Designing a new channel brand identity, mission, and audience persona
14
+ - Developing a 30-day master content strategy document (`plan.md`)
15
+ - Setting up the 14-day cold start publishing schedule (70% Reels / 30% In-stream)
16
+ - Calculating RPM KPI targets and affiliate product placement strategies
17
+
18
+ ## Required Input
19
+ - Channel Name / Brand Concept
20
+ - Primary Genre / Niche (e.g., Horror/Folklore, Healing/Self-Care, Zen/Philosophy, Life Lessons, Wellness/Health, Nostalgia/Poetry, Finance)
21
+ - Target Audience Demographics & Core Pain Points
22
+
23
+ ## Step-by-Step Workflow
24
+
25
+ ### Step 1: Channel Branding & Identity
26
+ Define the core channel parameters:
27
+ - **Brand Name**: Pure brand name ONLY. ❌ NEVER prefix with `[Channel]` or `[Kênh]`.
28
+ - **Slogan / Tagline**: Concise, emotional, memorable.
29
+ - **Visual Identity**: Primary theme color (HEX code) and Lucide Icon name (e.g., `HeartHandshake`, `Ghost`, `BookOpen`, `Coffee`, `Heart`, `Feather`, `Sparkles`).
30
+ - **Category & Sub-niche**: Clear classification aligned with MTxStudio taxonomy.
31
+
32
+ ### Step 2: Audience Persona & Psychological Drivers
33
+ Define:
34
+ - **Demographics**: Age bracket, gender ratio, occupation, daily routine.
35
+ - **Golden Posting Hours**: Specific time slots when this audience is most receptive:
36
+ - Night stories: 21:00 - 23:30
37
+ - Zen / Morning motivation: 06:00 - 07:30
38
+ - Midday work break: 11:45 - 13:00
39
+ - Evening emotional healing: 20:00 - 21:30
40
+ - **Emotional Trigger**: Tension -> Fear -> Relief (Horror); Empathy -> Healing -> Hope (Healing); Fatigue -> Calm -> Energy (Wellness).
41
+
42
+ ### Step 3: 5-Pillar Content Matrix
43
+ Construct a balanced 5-pillar content distribution:
44
+ 1. **Pillar 1 (Core Identity / Signature Story)**: 30% volume - High-retention foundational narrative.
45
+ 2. **Pillar 2 (Empathy & Pain Point Hook)**: 25% volume - Relatable short-form Reels addressing viewer frustrations.
46
+ 3. **Pillar 3 (Practical Guidance & Wisdom)**: 20% volume - Actionable steps, insights, or exercises.
47
+ 4. **Pillar 4 (Interactive & Community Reflection)**: 15% volume - Philosophical questions, quotes, and discussions.
48
+ 5. **Pillar 5 (Soft-sell & Affiliate Alignment)**: 10% volume - Organic product recommendation.
49
+
50
+ ### Step 4: 14-Day Cold Start Strategy
51
+ - **Format ratio**: 70% Short Reels (30-50s) + 30% Long In-stream (>3 mins).
52
+ - **Week 1 (Audience Warming)**: 1-2 Reels/day, 1 In-stream video every 2 days.
53
+ - **Week 2 (Retention Acceleration)**: 2 Reels/day + 1 In-stream video/day.
54
+
55
+ ### Step 5: Monetization & KPI Modeling
56
+ - Target RPM: $0.02 to $0.05 per 1,000 eligible views.
57
+ - Initial Milestone: Reach 10,000 followers and satisfy in-stream monetization thresholds.
58
+ - Affiliate product tiers: Tier A (Direct relevance, Pinned comment), Tier B (Bio link / Catalog).
59
+
60
+ ## Expected Output
61
+ - A comprehensive `plan.md` file saved at `Facebook/[Channel-Folder]/plan.md` with:
62
+ 1. Brand positioning & identity metadata.
63
+ 2. 5-pillar content matrix with percentage allocations.
64
+ 3. 14-day cold start publishing schedule.
65
+ 4. Revenue matrix and RPM targets.
66
+
67
+ ---
68
+
69
+ ## Universal Activation Prompt Template
70
+
71
+ ```text
72
+ Use skill content-strategy to build a 30-Day Master Plan (plan.md) for a new channel:
73
+ - Channel Name: [Insert pure brand name, e.g., An Trú Quán]
74
+ - Niche: [e.g., Mindfulness & Zen Living]
75
+ - Target Audience: [e.g., Working adults aged 22-45 facing daily stress]
76
+ - Output Language: Vietnamese (or specified target language)
77
+ - Requirements: Include brand identity, 5 content pillars, 14-day cold start schedule (70% Reels / 30% In-stream), golden posting hours, and monetization projections.
78
+ ```
@@ -0,0 +1,74 @@
1
+ ---
2
+ name: content-vault-sync
3
+ description: Data integrity verification, character sanitization, and automated export of channel resources to MTxStudio Content Vault JSON bundles.
4
+ projectType: content-channel
5
+ ---
6
+
7
+ # Skill: Content Vault Sync & Packaging
8
+
9
+ ## Purpose
10
+ Validate and package multi-channel scripts, strategy plans, prompts, and affiliate catalogs into sanitized JSON bundles compatible with MTxStudio's Script & Content Vault (v2).
11
+
12
+ ## When to Use
13
+ - After adding or modifying channel scripts, plans, or prompt files
14
+ - After scaffolding a new channel to generate its importable package
15
+ - To regenerate `all_channels_bundle.json` or `mtxstudio_vault_import.json`
16
+
17
+ ## Critical Operational Constraints
18
+ 1. **NEVER modify SQLite `mtxstudio.db` directly**: Always export clean JSON files so users can safely import them through the MTxStudio UI without risk of database corruption.
19
+ 2. **Character Sanitization**:
20
+ - Zero tolerance for en-dash `–` or em-dash `—`. The export script automatically converts them to `-` and `--`.
21
+ - UTF-8 encoding with Vietnamese diacritics preserved (`ensure_ascii=False`).
22
+ 3. **Type & ContentType Taxonomy**:
23
+ - Categories:
24
+ - Root: `type: "article"`
25
+ - Plan / Docs: `type: "docs"`
26
+ - Posts / Scripts: `type: "article"`
27
+ - Prompts: `type: "prompts"`
28
+ - Music: `type: "music"`
29
+ - Affiliate: `type: "docs"`
30
+ - Scripts:
31
+ - Posts: `contentType: "post"`
32
+ - Master Plan: `contentType: "plan"`
33
+ - Guide / Disclaimer: `contentType: "guide"`
34
+ - Visual Prompts: `contentType: "prompt_image"`
35
+ - Music Prompts: `contentType: "prompt_music"`
36
+
37
+ ---
38
+
39
+ ## Step-by-Step Execution Workflow
40
+
41
+ ### Step 1: Pre-Export Audit
42
+ Verify that:
43
+ - Channel directories contain `plan.md`.
44
+ - Posts in `posts/` follow the 6-part markdown schema.
45
+ - No `[Channel]` or `[Kênh]` prefix in channel folder names.
46
+
47
+ ### Step 2: Execute Vault Exporter
48
+ Run the export script in the terminal:
49
+ ```bash
50
+ python Facebook/export_vault_json.py
51
+ ```
52
+
53
+ ### Step 3: Verify Output Bundles
54
+ Confirm generation of:
55
+ - `Facebook/mtxstudio_vault_import.json` (Full ecosystem ready for 1-click import into MTxStudio)
56
+ - `Facebook/all_channels_bundle.json` (Consolidated multi-channel database)
57
+ - `Facebook/[Channel-Folder]/[channel_slug]_package.json` (Individual channel standalone bundle)
58
+
59
+ ### Step 4: Validate JSON Syntax & Counts
60
+ Ensure the script reports zero syntax errors and accurately counts:
61
+ - Total channels / root categories
62
+ - Subcategories (4-5 per channel)
63
+ - Total script items, prompts, and affiliate links
64
+
65
+ ---
66
+
67
+ ## Universal Activation Prompt Template
68
+
69
+ ```text
70
+ Use skill content-vault-sync to synchronize and package channel data:
71
+ - Run integrity audit on all channels in Facebook/
72
+ - Execute export_vault_json.py to rebuild mtxstudio_vault_import.json and all_channels_bundle.json
73
+ - Report total channels, categories, and packaged scripts.
74
+ ```