@rfxlamia/skillkit 1.0.0

package/skills/coolhunter/workflow-plan-coolhunter.md

@@ -0,0 +1,232 @@
+---
+status: COMPLETE
+completionDate: 2025-12-31
+stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9]
+---
+
+# Workflow Creation Plan: coolhunter
+
+## Initial Project Context
+
+- **Module:** stand-alone
+- **Target Location:** /home/v/project/AI-Agile-Creative-Studio/creative-studio/workflow/creative-studio/workflows/coolhunter
+- **Created:** 2025-12-31
+
+## Requirements
+
+### Purpose and Scope
+
+- **Primary user:** V
+- **Primary deliverable:** Always a Markdown “trend report”
+- **Source material:** Transform from `creative-studio/skill/coolhunter/SKILL.md`
+
+### Workflow Type
+
+- **Type:** Mixed workflow (interactive + action/web research + document output)
+
+### Flow / Intents
+
+- **Keep existing intents/modes as-is:**
+  - `coolhunt [topic]` = full research workflow
+  - `news scan [topic]` = quick news gathering (simplified route)
+  - `trend analysis` / `analyze this trend` = analysis-only route
+
+### Input Requirements
+
+- **Required input:** Topic (for `coolhunt` / `news scan`)
+- **Optional input:** User-provided links/snippets (offline-friendly mode)
+- **Browsing:** Supported and expected “most of the time”
+
+### Output Specifications
+
+- **Output format:** Markdown report (headline, summary, fact-check, behavioral analysis)
+- **Auto-save:** Yes
+- **Save path convention:** `coolhunter-output/report-{datetime}/...` (match existing skill behavior)
+
+### Success Criteria
+
+- **Sources**
+  - Minimum: 2
+  - Target: 3–5
+  - Excellent: 5+ diverse
+- **Signals extracted**
+  - Minimum: 2
+  - Target: 3–4
+  - Excellent: 5+ distinct
+- **Recency**
+  - Minimum: <7 days
+  - Target: <48 hours
+  - Excellent: <24 hours
+- **Fact-check claims**
+  - Minimum: 2
+  - Target: 3–5
+  - Excellent: All major claims
+- **Behavioral implications**
+  - Minimum: 1 category
+  - Target: 2 categories
+  - Excellent: All 3 categories
+
+## Tools Configuration
+
+### Core BMAD Tools
+
+- **Party-Mode**: included - Integration points: optional multi-persona debate/synthesis for (a) ambiguous signals, (b) controversial topics, (c) conflicting sources, (d) headline + “Coolhunter’s Take” framing
+- **Advanced Elicitation**: included - Integration points: quality-gate pass before finalizing the report (method selection check + claim verification rigor + confidence calibration), plus on-demand deep dives
+- **Brainstorming**: included - Integration points: widening search angles/subtopics, generating hypotheses, and generating “Watch For / Timeline / Opportunity Window” variants from signals
+
+### LLM Features
+
+- **Web-Browsing**: included - Use cases: default for `coolhunt` and `news scan` with recency targeting (<48h, ideally <24h); fallback supports user-provided links/snippets
+- **File I/O**: included - Operations: create output directory + slugified filename; save report to `coolhunter-output/report-{YYYY-MM-DD-HHmm}/{title-slug}.md`
+- **Sub-Agents**: included - Use cases: parallelize (a) source discovery, (b) per-source signal extraction, (c) claim verification / cross-source consistency checks
+- **Sub-Processes**: included - Use cases: parallel research/extraction pipelines when browsing returns many candidates
+
+### Memory Systems
+
+- **Sidecar File**: included - Purpose: remember preferences across runs (e.g., time window defaults, source preferences/blocks, quality thresholds, recurring topics/angles)
+
+### External Integrations
+
+- **No-install integrations included** (excluded install-required items such as git-integration, vector-database, and other install-required MCPs)
+
+### Elicitation Method Catalog (Workflow-Local Reference)
+
+- **Primary curated catalog:** `creative-studio/skill/coolhunter/assets/elicitation-methods.csv` (50 methods, categories, patterns)
+- **Extended descriptions:** `creative-studio/skill/coolhunter/knowledge/elicitation-methods.md`
+- **Execution reference:** `creative-studio/skill/coolhunter/references/workflow-execution.md` (context scoring + selection matrix + report/fact-check rules)
+
+### Installation Requirements
+
+- **Tools requiring installation**: none (by selection)
+- **User Installation Preference**: avoid install-required integrations
+
+## Plan Review and Approval
+
+- **Plan reviewed:** 2025-12-31
+- **User approval:** Approved (continue to design)
+- **Notes:** No changes requested during review
+
+## Output Format Design
+
+**Format Type**: Structured
+
+**Output Requirements**:
+
+- Document type: Trend report
+- File format: Markdown (`.md`)
+- Frequency: Per run (one report per run)
+- Save path: `coolhunter-output/report-{YYYY-MM-DD-HHmm}/{title-slug}.md`
+
+**Structure Specifications** (required sections, flexible content within each):
+
+- `# [COOLHUNTER HEADLINE]` (original interpretation, not copied)
+- Generated metadata block:
+  - `Generated: {datetime}`
+  - `Topic: {original_request}`
+  - `Analysis Method: {selected_method}`
+- `## 📰 News Summary` (cover what happened, why it matters, who’s involved; can include multiple sources)
+- `## ✅ Fact-Check` (claims table with ✅/⚠️/❌, plus confidence level + notes)
+- `## 🔮 Behavioral & Cultural Analysis`
+  - `### Consumer Behavior Shifts`
+  - `### Cultural Signals`
+  - `### Technology Adoption Curve`
+  - `### Pre-Mainstream Indicators`
+- `## 🎯 Coolhunter's Take` (forward-looking synthesis + Watch For / Timeline / Opportunity Window)
+- `## 📚 Sources` (full citations + URLs)
+
+**Special Considerations**:
+
+- Follow success criteria quality gates (sources/signals/recency/fact-check/behavioral categories).
+- When recency <48h is not possible, expand search window up to <7 days and explicitly note the limitation.
+
+## Workflow Structure Design
+
+### Continuation Support
+
+- **Multi-session support:** Yes
+- **Design decision:** Include `step-01b-continue.md` to resume from prior runs using output frontmatter (`stepsCompleted`) + sidecar preferences.
+
+### Step Outline (Blueprint)
+
+1. **step-01-init** — Initialize session, detect whether resuming, set run context (topic/mode), explain outputs + save path.
+2. **step-01b-continue** (conditional) — Load prior state/output, confirm next step, resume execution.
+3. **step-02-route-intent** — Determine intent: `coolhunt` vs `news scan` vs `trend analysis`; confirm topic/inputs (links/snippets optional) and time-window target.
+4. **step-03-research-and-signal-extract** — Web browse (or offline sources) + evaluate sources + extract per-source signals (support sub-agents/sub-processes).
+5. **step-04-elicitation-method-select-and-apply** — Context scoring → select method(s) from curated catalog → apply pattern(s) → generate insights + implications.
+6. **step-05-report-and-save** — Assemble structured Markdown report, run quality gates (success criteria), slugify headline, save to `coolhunter-output/report-{YYYY-MM-DD-HHmm}/{title-slug}.md`.
+
+### Interaction Patterns (Menus / Decision Points)
+
+- **Route selection:** Confirm intent + topic, accept optional links/snippets, confirm recency target.
+- **Research controls:** Option to widen search angles/subtopics, accept fewer sources when coverage is limited, or expand recency window up to <7 days with explicit note.
+- **Analysis controls:** Option to accept suggested elicitation method, pick from categories, or invoke party-mode for ambiguous/contested signals.
+- **Pre-save review:** Option to re-run fact-checking, add sources, adjust headline/slug, or proceed to save.
+
+### Data Flow / State Tracking
+
+- **Tracked in output report frontmatter:** `stepsCompleted`, `topic`, `intent`, `selected_method(s)`, `sources`, `signals`, `claims`, `confidence`, `datetime`, `slug`.
+- **Sidecar preferences (cross-run):** recency defaults, source preferences/blocks, and quality thresholds.
+
+### File Structure (Workflow Folder)
+
+Target folder: `creative-studio/workflow/creative-studio/workflows/coolhunter/`
+
+- `workflow.md`
+- `steps/step-01-init.md`
+- `steps/step-01b-continue.md`
+- `steps/step-02-route-intent.md`
+- `steps/step-03-research-and-signal-extract.md`
+- `steps/step-04-elicitation-method-select-and-apply.md`
+- `steps/step-05-report-and-save.md`
+- `assets/elicitation-methods.csv` (copy from `creative-studio/skill/coolhunter/assets/elicitation-methods.csv` for workflow self-containment)
+
+## Build Summary
+
+### Generated Files
+
+- `creative-studio/workflow/creative-studio/workflows/coolhunter/workflow.md`
+- `creative-studio/workflow/creative-studio/workflows/coolhunter/templates/report-template.md`
+- `creative-studio/workflow/creative-studio/workflows/coolhunter/steps/step-01-init.md`
+- `creative-studio/workflow/creative-studio/workflows/coolhunter/steps/step-01b-continue.md`
+- `creative-studio/workflow/creative-studio/workflows/coolhunter/steps/step-02-route-intent.md`
+- `creative-studio/workflow/creative-studio/workflows/coolhunter/steps/step-03-research-and-signal-extract.md`
+- `creative-studio/workflow/creative-studio/workflows/coolhunter/steps/step-04-elicitation-method-select-and-apply.md`
+- `creative-studio/workflow/creative-studio/workflows/coolhunter/steps/step-05-report-and-save.md`
+- `creative-studio/workflow/creative-studio/workflows/coolhunter/assets/elicitation-methods.csv` (copied from `creative-studio/skill/coolhunter/assets/elicitation-methods.csv`)
+
+### Customizations / Notes
+
+- Workflow is stand-alone (non-pipeline) and writes reports to `{project-root}/coolhunter-output/report-{YYYY-MM-DD-HHmm}/{title-slug}.md`.
+- Continuation support implemented via `step-01-init.md` detection + `step-01b-continue.md` resume flow.
+- Curated elicitation catalog is workflow-local at `assets/elicitation-methods.csv`.
+
+### Next Steps (Validation)
+
+- Run a dry execution by starting at `creative-studio/workflow/creative-studio/workflows/coolhunter/workflow.md` and following `step-01-init.md`.
+
+## Review Summary
+
+### Validation Results
+
+- Configuration validation: PASSED
+- Step compliance: PASSED
+- Cross-file consistency: PASSED
+- Requirements verification: PASSED
+
+### Completeness Check
+
+- All required files present (workflow, steps, template, assets).
+- YAML frontmatter parses cleanly across all generated `.md` files.
+- Step sequencing is consistent (`nextStepFile` references resolve).
+- Step file sizes are within best-practice range (≈3–4KB each).
+
+### Issues Found
+
+- **Critical Issues:** none
+- **Warnings:** none
+- **Suggestions:** Optional: add a `README.md` in the workflow folder documenting invocation examples (`coolhunt [topic]`, `news scan [topic]`, `trend analysis`) and the output directory convention.
+
+### Usage Guidance
+
+- Entry point: `creative-studio/workflow/creative-studio/workflows/coolhunter/workflow.md`
+- Reports saved under: `{project-root}/coolhunter-output/report-{YYYY-MM-DD-HHmm}/{title-slug}.md`

package/skills/creative-copywriting/SKILL.md

@@ -0,0 +1,324 @@
+---
+name: creative-copywriting
+description: >
+  Master persuasive writing for social media with proven hooks, storytelling frameworks, and 
+  psychological triggers. Includes CSV databases with 150+ hooks, power words, carousel 
+  structures, and emotional triggers specifically optimized for Instagram swipes and X/Twitter
+  "Read more" clicks. Works with creative-copywriter subagent for intelligent content generation.
+category: creative
+---
+
+# Creative Copywriting (2025)
+
+Transform words into scroll-stopping, swipe-inducing, click-compelling content using psychology-backed copywriting techniques.
+
+## What This Skill Solves
+
+**The Attention Economy Problem:**
+- Average attention span: 8 seconds (less than a goldfish)
+- 47% scroll past content without engaging
+- Visual hooks now outperform verbal hooks (2025 shift)
+- Storytelling builds 22x more memorable content than facts alone
+
+**This skill provides:**
+1. **Hook formulas** - First 3 seconds that stop the scroll
+2. **Power word databases** - 200+ emotional trigger words by category
+3. **Carousel storytelling** - Structures that maximize swipe-through rate
+4. **Psychological triggers** - Evidence-backed persuasion techniques
+5. **Read more optimization** - X/Twitter-specific expansion triggers
+
+## When to Use This Skill
+
+**Trigger patterns:**
+- "Write a hook for my Instagram carousel"
+- "Make this caption more engaging"
+- "Create swipe-worthy content"
+- "Power words for [emotion/goal]"
+- "Storytelling framework for [topic]"
+- "Make people click Read more"
+- "Hook variations for A/B testing"
+
+**Use with creative-copywriter subagent** for intelligent generation with database queries.
+
+## Core Methodology
+
+### The Hook-Story-Action Framework
+
+Every piece of social content follows this arc:
+
+```
+HOOK (0-3 sec) → STORY (3-30 sec) → ACTION (final moment)
+    ↓               ↓                  ↓
+Stop scroll    Build emotion      Drive behavior
+```
+
+### 1. Hooks: The First 3 Seconds
+
+**Hook Categories (2025 Effectiveness Ranking):**
+
+| Type | Description | Best For | Avg Stop Rate |
+|------|-------------|----------|---------------|
+| Visual Hook | Movement, contrast, unexpected visual | Reels, Carousels | 12.3% |
+| Curiosity Gap | Incomplete information, open loop | All platforms | 9.8% |
+| Controversy | Bold opinion, myth-busting | X/Twitter, Threads | 9.2% |
+| Personal Story | "I failed...", vulnerability | Instagram, LinkedIn | 8.7% |
+| Data Shock | Surprising statistic | Educational content | 8.1% |
+| Question Hook | Thought-provoking question | All platforms | 7.4% |
+
+**Hook Anatomy:**
+```
+[Emotion Trigger] + [Specificity] + [Open Loop]
+
+Example: "I lost 10k followers (emotion) in 7 days (specific) doing this one thing... (open loop)"
+```
+
+### 2. Power Words: Emotional Triggers
+
+Words that bypass logic and hit emotions directly.
+
+**Categories:**
+- **Urgency**: Now, Limited, Ending, Today, Before
+- **Exclusivity**: Secret, Insider, Hidden, Rare, Private
+- **Curiosity**: Discover, Reveal, Uncover, Finally, Truth
+- **Fear**: Warning, Mistake, Avoid, Risk, Don't
+- **Desire**: Ultimate, Perfect, Dream, Transform, Unlock
+- **Trust**: Proven, Guaranteed, Authentic, Real, Tested
+- **Anger/Agitation**: Sick of, Fed up, Frustrating, Enough, Stop
+
+**Usage Rule:** 1-2 power words per hook (more = manipulation feel)
+
+### 3. Carousel Storytelling: Swipe Architecture
+
+**The 7-Slide Narrative Arc:**
+
+```
+Slide 1: HOOK - Stop the scroll (bold visual + curiosity)
+Slide 2: SETUP - Establish the problem/context
+Slide 3: TENSION - Agitate (why this matters)
+Slide 4: BRIDGE - Hint at solution
+Slide 5: VALUE - Core insight/transformation
+Slide 6: PROOF - Evidence, example, or story
+Slide 7: CTA - Clear next step
+```
+
+**Swipe Triggers Between Slides:**
+- End slide mid-sentence: "But here's where it gets..."
+- Visual continuation: Arrow, numbered sequence
+- Pattern interrupt: Change color, introduce character
+- Cliffhanger: "The result surprised everyone..."
+
+**Carousel Types by Goal:**
+
+| Type | Structure | Swipe Rate | Best For |
+|------|-----------|------------|----------|
+| Educational | Problem → Steps → Result | 65% | Authority building |
+| Story | Setup → Conflict → Resolution | 72% | Connection |
+| List/Ranking | Intro → Items → Summary | 58% | Saves, shares |
+| Transformation | Before → Process → After | 78% | Proof, inspiration |
+| Myth-Busting | Myth → Truth → Evidence | 61% | Engagement, shares |
+
+### 4. Read More Triggers (X/Twitter)
+
+**First 280 Characters Must:**
+1. Front-load the hook (first 50 chars)
+2. Create incomplete pattern
+3. Promise value continuation
+4. Use strategic line breaks
+
+**Expansion Triggers:**
+- Numbers: "7 things I learned..." (brain wants to complete the set)
+- Lists: "Here's what changed: 1." (incomplete list)
+- Story start: "Last week something happened..." (narrative gap)
+- Contradiction: "Everyone says X. They're wrong." (curiosity)
+
+### 5. Psychological Principles
+
+**Core Triggers (Backed by Research):**
+
+| Trigger | Psychology | Usage |
+|---------|------------|-------|
+| Curiosity Gap | Brain needs closure | Open loops, incomplete info |
+| Social Proof | Herd behavior | Numbers, testimonials |
+| Scarcity | Loss aversion | Limited time/quantity |
+| Reciprocity | Give before ask | Free value first |
+| Authority | Expert trust | Credentials, data |
+| FOMO | Fear of missing | Trends, urgency |
+| Specificity | Credibility | Exact numbers, details |
+| Story | Memory formation | Narrative structure |
+
+## How to Use The Databases
+
+### Available Databases
+
+**P0 (Core):**
+- `hook-formulas.csv` - 50+ hooks by type, platform, emotion
+- `power-words.csv` - 200+ words by emotion category
+
+**P1 (Advanced):**
+- `carousel-structures.csv` - 15+ storytelling frameworks
+- `swipe-triggers.csv` - 30+ between-slide transitions
+- `psychological-triggers.csv` - 20+ persuasion techniques
+
+**P2 (Intelligence):**
+- `read-more-patterns.csv` - 25+ X/Twitter expansion patterns
+- `emotional-arcs.csv` - 10+ complete emotional journeys
+
+### Query Pattern
+
+**Manual Search:**
+1. Identify goal: Hook? Story? Emotion?
+2. Filter by: platform, emotion_trigger, effectiveness
+3. Select 2-3 patterns
+4. Adapt to your content/voice
+
+**With creative-copywriter subagent:**
+```
+User: "Hook for Instagram carousel about productivity"
+→ Subagent queries: platform=instagram, content_type=carousel, topic=productivity
+→ Returns: Top 3 hooks with emotion triggers
+→ Generates: 3 customized variations with reasoning
+```
+
+## Quick Start Guide
+
+### For Instagram Carousels
+
+1. **Slide 1 Hook Formula:**
+   ```
+   [Power Word] + [Specific Outcome] + [Time Frame]
+   "The hidden technique that 10x'd my reach in 7 days"
+   ```
+
+2. **Swipe momentum:**
+   - Each slide ends with incomplete thought
+   - Visual consistency (same template, colors)
+   - Text size: readable in 2 seconds
+   - Maximum 3 ideas per slide
+
+3. **Final slide:**
+   - Clear CTA (save, follow, comment)
+   - Recap value delivered
+   - Easy to screenshot/share
+
+### For X/Twitter Threads
+
+1. **Tweet 1 formula:**
+   ```
+   [Hook] + [Promise] + [Specificity]
+   "I analyzed 1,000 viral tweets. Here's the pattern nobody talks about: 🧵"
+   ```
+
+2. **Thread structure:**
+   - Tweet 1: Hook + promise
+   - Tweets 2-8: Deliver value (one idea per tweet)
+   - Tweet 9: Summary/key takeaway
+   - Tweet 10: CTA + retweet request
+
+3. **Read more triggers:**
+   - Strategic truncation (let algorithm cut at curiosity point)
+   - First tweet hooks continuation
+   - Numbers create completion drive
+
+### For Stories/Reels Scripts
+
+1. **First 3 seconds:**
+   - Movement > Static
+   - Face > No face
+   - Text hook + verbal hook
+
+2. **Story arc:**
+   ```
+   0-3s: Pattern interrupt (visual hook)
+   3-10s: Promise setup
+   10-30s: Value delivery
+   30-45s: Proof/example
+   45-60s: CTA
+   ```
+
+## Integration with creative-copywriter Subagent
+
+The **creative-copywriter subagent** provides intelligent orchestration:
+
+**Capabilities:**
+1. Multi-database querying (hooks + power words + triggers)
+2. Emotion-based generation (match intent to triggers)
+3. Platform-specific adaptation
+4. A/B variation generation (different emotional angles)
+5. Storytelling framework recommendations
+
+**Example workflow:**
+```
+User: "Create carousel about overcoming imposter syndrome"
+
+creative-copywriter:
+1. Identifies: emotional topic → story-driven approach
+2. Queries carousel-structures.csv: type=transformation
+3. Queries hook-formulas.csv: emotion=vulnerability
+4. Queries power-words.csv: category=empowerment
+5. Generates: Complete 7-slide narrative with hooks and transitions
+```
+
+## Best Practices
+
+**Hooks:**
+- ✅ Lead with emotion, follow with logic
+- ✅ Be specific (numbers, time frames)
+- ✅ Create incomplete patterns
+- ❌ Don't clickbait (promise must match delivery)
+- ❌ Don't use more than 2 power words per hook
+
+**Storytelling:**
+- ✅ One idea per slide/tweet
+- ✅ End each unit with forward momentum
+- ✅ Include yourself in the story (relatability)
+- ❌ Don't info-dump
+- ❌ Don't break the narrative flow
+
+**Power Words:**
+- ✅ Use strategically (scarcity, not abundance)
+- ✅ Match emotion to content intent
+- ✅ Test variations
+- ❌ Don't overuse (manipulation feel)
+- ❌ Don't mismatch emotion (urgency for evergreen content)
+
+**Psychology:**
+- ✅ Give value before asking
+- ✅ Be authentic (fake triggers backfire)
+- ✅ Respect audience intelligence
+- ❌ Don't manipulate (ethical persuasion only)
+- ❌ Don't use fear without offering solution
+
+## Notes and Limitations
+
+**Authenticity First:**
+- These techniques amplify good content, not replace it
+- Manipulation without value = audience erosion
+- Building trust > Short-term engagement
+
+**Platform Evolution:**
+- Visual hooks rising (2025 trend)
+- Verbal hooks declining effectiveness
+- Story > Tips format shift
+- Minimalist editing preferred
+
+**Cultural Context:**
+- Power words vary by language/culture
+- Test with your specific audience
+- Localize emotion triggers
+
+## References
+
+**Detailed Guides:**
+- `references/hook-anatomy.md` - Deep dive into hook construction
+- `references/carousel-psychology.md` - Why carousels work
+- `references/power-word-science.md` - Psychology behind trigger words
+- `references/storytelling-frameworks.md` - Complete narrative structures
+
+**CSV Databases:**
+- `databases/hook-formulas.csv`
+- `databases/power-words.csv`
+- `databases/carousel-structures.csv`
+- `databases/swipe-triggers.csv`
+- `databases/psychological-triggers.csv`
+- `databases/read-more-patterns.csv`
+- `databases/emotional-arcs.csv`

package/skills/creative-copywriting/databases/README.md

@@ -0,0 +1,60 @@
+# Creative Copywriting Databases (CSV)
+
+These CSV files are a project-local knowledge base used by the `creative-copywriting` workflow to select hooks, triggers, and structures without relying on web browsing.
+
+## Usage Principles
+
+- Use these CSVs as **lookup tables** (pick a small number of relevant rows) rather than dumping large lists into the conversation.
+- When a row meaningfully influences an output choice (hook/trigger/structure), prefer citing its `num` and `*_name`/`hook_type` in the workflow output for traceability.
+- Keep the workflow **intent-based**: the CSVs guide selection; they should not force rigid scripts.
+
+## Files
+
+### `hook-formulas.csv`
+
+- **Purpose:** Hook patterns by platform with example formulas and expected engagement (stop rate).
+- **Primary columns:** `num`, `hook_type`, `platform`, `formula`, `example`, `emotion_trigger`, `psychology_principle`, `stop_rate`, `best_for`, `notes`
+- **Used in:** `step-03-strategy.md`, `step-04-variations.md`
+
+### `psychological-triggers.csv`
+
+- **Purpose:** Trigger registry with ethical-use notes and manipulation warnings.
+- **Primary columns:** `num`, `trigger_name`, `psychology_principle`, `description`, `application`, `example_copy`, `power_level`, `ethical_use`, `manipulation_warning`
+- **Used in:** `step-03-strategy.md`, `step-06-qa.md` (as a checklist/reference)
+
+### `power-words.csv`
+
+- **Purpose:** Curated “power word” index for emotional framing, with contexts to use/avoid.
+- **Primary columns:** `num`, `word`, `category`, `emotion_trigger`, `intensity`, `best_context`, `avoid_context`, `example_usage`
+- **Used in:** `step-03-strategy.md`, `step-04-variations.md`, `step-05-draft.md`
+- **Note:** This file is the largest CSV in this set; consider splitting by category if it grows.
+
+### `swipe-triggers.csv`
+
+- **Purpose:** Swipe/click continuation phrases and placement guidance for carousels/threads.
+- **Primary columns:** `num`, `trigger_type`, `trigger_text`, `psychology`, `placement`, `effectiveness`, `example`, `notes`
+- **Used in:** `step-03-strategy.md`, `step-04-variations.md`
+
+### `read-more-patterns.csv`
+
+- **Purpose:** Read-more truncation patterns for captions/threads to increase expansion.
+- **Primary columns:** `num`, `pattern_name`, `formula`, `truncation_strategy`, `example`, `expansion_rate`, `best_for`, `psychology`, `notes`
+- **Used in:** `step-03-strategy.md`, `step-04-variations.md`
+
+### `carousel-structures.csv`
+
+- **Purpose:** Carousel structure templates (slide-by-slide) mapped to outcomes and CTA types.
+- **Primary columns:** `num`, `structure_name`, `type`, `slide_count`, `structure_template`, `example_topic`, `swipe_rate`, `best_for`, `hook_style`, `cta_type`, `psychology_principle`
+- **Used in:** `step-03-strategy.md`, `step-04-variations.md`
+
+### `emotional-arcs.csv`
+
+- **Purpose:** Story/emotion arcs for longer-form threads and narrative carousels.
+- **Primary columns:** `num`, `arc_name`, `structure`, `emotions_sequence`, `duration`, `use_case`, `example_topic`, `engagement_level`, `resolution_type`
+- **Used in:** `step-03-strategy.md`, `step-04-variations.md`
+
+## Maintenance
+
+- When adding new rows, keep columns consistent and avoid duplicate entries.
+- Prefer concrete, specific entries over generic statements.
+- If you add external sources or statistics, document sources in the corresponding workflow references (Markdown) and keep the CSV as an index/registry.

package/skills/creative-copywriting/databases/carousel-structures.csv

@@ -0,0 +1,16 @@
+num,structure_name,type,slide_count,structure_template,example_topic,swipe_rate,best_for,hook_style,cta_type,psychology_principle
+1,Problem-Solution Arc,educational,7,"S1:Hook problem | S2:Agitate | S3:Introduce solution | S4-5:Steps | S6:Proof | S7:CTA",productivity tips,65%,authority building,data_shock,follow_save,pain-relief
+2,Story Transformation,story,8,"S1:Before state | S2:Problem hit | S3:Rock bottom | S4:Discovery | S5-6:Journey | S7:After state | S8:CTA",personal growth,78%,connection building,personal_failure,share_comment,hero_journey
+3,Myth-Busting,educational,6,"S1:Common myth | S2:Why people believe | S3:The truth | S4-5:Evidence | S6:What to do instead",industry myths,61%,thought leadership,controversy,engage_debate,cognitive_dissonance
+4,Numbered List,listicle,10,"S1:Hook with number | S2-9:One item per slide | S10:Summary + CTA",tips tricks,58%,saves shares,number_list,save_share,completion_drive
+5,Before-After,transformation,5,"S1:Before state | S2:The change | S3:During process | S4:After state | S5:How to replicate",results showcase,72%,proof inspiration,before_after,dm_inquiry,social_proof
+6,Day-in-Life,story,7,"S1:Morning hook | S2-6:Time progression | S7:Evening reflection + CTA",lifestyle content,64%,relatability,story_opener,follow_comment,parasocial_connection
+7,Behind-the-Scenes,transparency,6,"S1:Polished result | S2:Reality reveal | S3-5:Process steps | S6:Final thoughts + CTA",creative process,69%,authenticity,pattern_interrupt,engage_follow,transparency_bias
+8,Comparison,educational,6,"S1:A vs B hook | S2:Factor 1 | S3:Factor 2 | S4:Factor 3 | S5:Verdict | S6:CTA",product comparison,63%,decision support,comparison,comment_opinion,choice_paralysis_relief
+9,Tutorial Steps,educational,8,"S1:End result hook | S2:What you need | S3-6:Step by step | S7:Common mistakes | S8:CTA",how-to content,67%,authority building,direct_benefit,save_try,reciprocity
+10,Controversial Take,thought_leadership,6,"S1:Hot take | S2:Why I believe this | S3-4:Evidence | S5:Nuance | S6:Your turn + CTA",industry opinions,71%,engagement debate,hot_take,comment_debate,controversy_engagement
+11,Failure to Success,story,9,"S1:The failure | S2:What went wrong | S3:Rock bottom | S4:The pivot | S5-7:New approach | S8:Success | S9:Lessons + CTA",comeback story,76%,inspiration trust,mistake_admission,follow_dm,redemption_arc
+12,Prediction,thought_leadership,5,"S1:Bold prediction | S2:Why now | S3-4:Evidence trends | S5:What to do + CTA",future trends,59%,authority,prediction,follow_discuss,authority_bias
+13,Resource Roundup,value,10,"S1:What you'll get | S2-9:One resource each | S10:Save this + CTA",tools resources,62%,saves shares,value_promise,save_share,reciprocity
+14,Quick Wins,educational,5,"S1:Fast results promise | S2-4:Quick tips | S5:Try now + CTA",instant tips,55%,engagement,direct_benefit,try_comment,instant_gratification
+15,Personal Journey,story,8,"S1:Where I am now | S2:Where I started | S3-6:Key moments | S7:Lessons | S8:Your turn + CTA",milestone content,73%,connection,time_travel,follow_share,journey_relatability

package/skills/creative-copywriting/databases/emotional-arcs.csv

@@ -0,0 +1,11 @@
+num,arc_name,structure,emotions_sequence,duration,use_case,example_topic,engagement_level,resolution_type
+1,Hero's Journey,"Setup → Call → Resistance → Mentor → Trials → Transformation → Return","comfort → disruption → fear → hope → struggle → triumph → wisdom",long,transformation stories,business success story,high,triumphant
+2,Rags to Riches,"Low point → Struggle → Discovery → Growth → Success","despair → determination → curiosity → effort → pride",medium,success stories,career growth,high,inspirational
+3,Overcoming Monster,"Peace → Threat → Fear → Battle → Victory","calm → anxiety → fear → courage → relief",medium,problem-solving,defeating algorithm,high,victorious
+4,Rebirth,"Sleep → Wake → Struggle → Transformation → New Life","stagnation → awareness → pain → growth → renewal",long,personal growth,mindset shift,high,transformative
+5,Voyage Return,"Home → Journey → Trials → Wisdom → Return","comfort → curiosity → challenge → insight → contentment",long,learning journeys,mastering a skill,medium,enlightened
+6,Comedy,"Confusion → Complications → Recognition → Resolution","puzzlement → frustration → realization → relief",short,relatable content,common mistakes,medium,satisfying
+7,Tragedy,"Height → Flaw → Fall → Consequence → Lesson","pride → blindness → shock → regret → wisdom",medium,cautionary tales,burnout story,high,educational
+8,Mystery,"Question → Clues → Red Herrings → Revelation → Understanding","curiosity → intrigue → confusion → surprise → clarity",medium,discovery content,algorithm secrets,high,revealing
+9,Underdog,"Dismissed → Challenge → Doubt → Perseverance → Triumph","hurt → determination → fear → grit → pride",medium,comeback stories,small creator success,high,empowering
+10,Confession,"Secret → Burden → Courage → Revelation → Relief","shame → heaviness → bravery → vulnerability → peace",short,authenticity content,admitting mistakes,high,cathartic