Content Kingdom

Content Kingdom Orchestrator

Overview

A lean 12-phase pipeline that turns raw trends into scheduled, analyzed, and scaled social media content — fully automated, with Paperclip issue tracking.

SOLID design:

• Each phase = single responsibility, independently runnable
• New phases: add to PHASE_REGISTRY in orchestrator.py — no other edits
• All new modules extend BaseModule (dependency inversion)
• Public API: 4 methods only (run_daily_pipeline, run_phase, get_status, create_paperclip_issues)

KISS design:

• Existing scripts called via subprocess — no reimplementation
• Only 2 truly new modules: comment_manager.py, engagement_engine.py
• Config extends autopilot_affiliate_engine/config.py at runtime

File Structure

skills/1ai-skills/content/content-kingdom/
├── SKILL.md                       ← you are here
├── orchestrator.py                ← BRAIN: thin coordinator
├── base_module.py                 ← BaseModule + PhaseResult (DI foundation)
├── config.json                    ← config (extends engine config at runtime)
├── state.json                     ← auto-generated: pipeline state
├── modules/
│   ├── __init__.py
│   ├── persona_manager.py         ← brand voice + caption generation
│   ├── comment_manager.py         ← Phase 8: ENGAGE (new)
│   ├── engagement_engine.py       ← Phase 12: SCALE (new)
│   ├── veris_design.py            ← v2.0: Veris Design System (prompts + palette)
│   └── geminigen_client.py        ← v2.0: GeminiGen API client (images + videos)
├── output/                        ← phase outputs (today_plan.json, scripts_*.json, …)
├── logs/                          ← daily orchestrator logs
├── templates/                     ← caption/storyboard templates
└── tests/                         ← unit tests

Symlink: skills/content-kingdom → skills/1ai-skills/content/content-kingdom

Veris Design Principles (v2.0)

Extracted from Veris (Ads Master, 10+ years) training session. Applied automatically in Phase 4: CREATE.

Core Rules (NON-NEGOTIABLE)

1. Pure black background — #000000, no exceptions, ever
2. High contrast white text — headlines in #FFFFFF, nothing below 60% opacity
3. Three-zone vertical layout — every ad must have: Hook / Body / CTA zones
4. No vibrant colors — accent palette limited to dark trust/urgency signals
5. No emoji in visuals — emoji in captions are OK, never in images
6. Minimalist premium — less elements = more premium feel = higher trust

Color Palette

Three-Zone Layout

┌─────────────────────────────┐
│  HOOK ZONE (top 20-30%)     │  ← Bold headline, stops the scroll
│  "Bisa Cuan 1 Juta/Hari?"  │
├─────────────────────────────┤
│  BODY ZONE (middle 40-50%) │  ← Product detail, builds desire
│  What it is, what it does  │
├─────────────────────────────┤
│  CTA ZONE (bottom 20-30%)  │  ← Action button, price, frame
│  [Lihat Sekarang → Rp 49K] │
└─────────────────────────────┘

Platform Priority (Veris Approach)

1. Instagram — PRIMARY (where ads convert)
2. Facebook — SECONDARY (older, higher spend audience)
3. Threads — TERTIARY (IG companion, free reach)
4. TikTok — QUATERNARY (volume play, lower CPM)

Formats

Using Veris in Code

from modules.veris_design import build_veris_prompt, veris_prompt_for_platform
from modules.geminigen_client import GeminiGenClient

# Build Veris-style prompt
payload = veris_prompt_for_platform(
    product_name="Guru Pintar AI",
    hook_text="Bisa Cuan Rp 1 Juta/Hari?",
    platform="instagram",
)

# Generate via GeminiGen
client = GeminiGenClient()
resp = client.generate_image(**payload)
url = client.generate_image_sync(**payload)  # sync version → returns URL

GeminiGen API (v2.0 — Primary Media Provider)

Base URL: https://api.geminigen.ai
Auth: x-api-key header
Key config: workspace/config/geminigen_api.json → {"api_key": "..."}

Supported Operations

Status Codes

• 1 = processing (keep polling)
• 2 = completed (extract URL)
• 3 = failed (raise error)

Phase 4 CREATE Provider Chain (v2.0)

Images:

GeminiGen (nano-banana-pro + Veris prompt)
  ↓ on failure
NVIDIA (Flux) via legacy media_generator  
  ↓ on failure
PIL placeholder (last resort — never blocks pipeline)

Videos:

GeminiGen (Grok-3, 480p portrait)
  ↓ on failure
BytePlus (Seedance T2V)

When to Use

Trigger phrases:

• "content kingdom"

• "\n Content Kingdom Orchestrator — the BRAIN that coordinates all 12 content pha"

• Running the full daily content pipeline (--pipeline)

• Running a specific phase only (--phase research, --phase schedule, etc.)

• Checking pipeline status after a run (--status)

• Creating Paperclip tracking issues for a run (--paperclip-issues)

• Debugging a broken phase in isolation

When NOT to Use

• ❌ Direct PostBridge posting → use autopilot_affiliate_engine/auto_postbridge_robust_v2.py
• ❌ Generating images only → use skills/nano-banana-pro/scripts/generate_image.py
• ❌ Research only → use autopilot_affiliate_engine/research_agent.py
• ❌ Revenue tracking only → use autopilot_affiliate_engine/revenue_tracker.py
• ❌ Storyboard only → use content/content-generator/scripts/storyboard.py

Quick Reference

# Full daily pipeline (morning run)
python3 orchestrator.py --pipeline

# Single phase (independently runnable)
python3 orchestrator.py --phase research
python3 orchestrator.py --phase plan
python3 orchestrator.py --phase script
python3 orchestrator.py --phase create
python3 orchestrator.py --phase review
python3 orchestrator.py --phase schedule
python3 orchestrator.py --phase post
python3 orchestrator.py --phase engage
python3 orchestrator.py --phase analyze
python3 orchestrator.py --phase optimize
python3 orchestrator.py --phase repurpose
python3 orchestrator.py --phase scale

# Status check
python3 orchestrator.py --status

# Seed Paperclip issues without running pipeline
python3 orchestrator.py --paperclip-issues

# Custom config
python3 orchestrator.py --pipeline --config /path/to/custom_config.json

Workflow

Content Kingdom runs a 12-phase daily pipeline. Each phase is a discrete step that feeds the next:

Execution: One morning run via cron. Each phase delegates to sub-agents through Paperclip issues. Failure mode: Any phase can be re-run independently without restarting the pipeline. Scaling: More channels = more research + create iterations in parallel.

The 12 Phases

Cron Setup

# Add to crontab (crontab -e)
# Morning pipeline — 08:00 WIB
0 8 * * * cd /home/openclaw/.openclaw/workspace/skills/content-kingdom && python3 orchestrator.py --pipeline >> logs/cron.log 2>&1

# Evening analysis — 20:00 WIB
0 20 * * * cd /home/openclaw/.openclaw/workspace/skills/content-kingdom && python3 orchestrator.py --phase analyze >> logs/cron.log 2>&1

# Engagement check — every 2 hours
0 */2 * * * cd /home/openclaw/.openclaw/workspace/skills/content-kingdom && python3 orchestrator.py --phase engage >> logs/cron.log 2>&1

Configuration

Edit config.json to change:

Do NOT duplicate values already in autopilot_affiliate_engine/config.py — they're merged at runtime.

Paperclip Integration

Each pipeline run creates:

• 1 parent issue: Content Kingdom — YYYY-MM-DD
• 12 sub-issues: one per phase
• Status auto-updates as phases complete (todo → done or blocked)

Paperclip server must be running at http://localhost:3100.

Adding a New Phase

1. Write a _phase_newphase(cfg, **kwargs) -> dict function in orchestrator.py
2. Add entry to PHASES dict: "newphase": {"fn": _phase_newphase, "label": "Phase 13: NEWPHASE", "deps": [...]}
3. Done. No other changes needed (Open/Closed principle).

Adding a New Module

If the new phase needs a real class:

# modules/my_new_module.py
from base_module import BaseModule

class MyNewModule(BaseModule):
    @property
    def name(self) -> str:
        return "my_phase"

    def _execute(self, **kwargs) -> dict:
        # single responsibility: do ONE thing
        return {"result": "done"}

Instantiate in the phase function, call module.run().

Common Mistakes

Dependencies

Python stdlib only + requests:

pip install requests

External scripts (must exist):

• autopilot_affiliate_engine/research_agent.py
• autopilot_affiliate_engine/auto_postbridge_robust_v2.py
• autopilot_affiliate_engine/evening_report.py
• autopilot_affiliate_engine/revenue_tracker.py
• content/content-generator/scripts/storyboard.py
• content/content-generator/scripts/quality_gate.py
• skills/nano-banana-pro/scripts/generate_image.py (optional — CREATE fallback chain)
• skills/auto-clipper/scripts/auto_clipper.py (optional — REPURPOSE phase degrades gracefully)

v2.0 additions:

• workspace/config/geminigen_api.json — {"api_key": "YOUR_KEY"} (required for GeminiGen primary provider)
• curl — CLI dependency for GeminiGen API calls (already available system-wide)

Example Output

{
  "run_id": "run_20260313_080000",
  "date": "2026-03-13",
  "phases": {
    "research": {"status": "success", "data": {"sources": ["research_agent", "viral_research_system"]}},
    "plan":     {"status": "success", "data": {"product_focus": "jendralbot_bundle", "platforms": ["tiktok", "instagram"]}},
    "script":   {"status": "success", "data": {"scripts_generated": 6}},
    "schedule": {"status": "success", "data": {"queue_file": "...postbridge_queue_jendralbot.json"}},
    "engage":   {"status": "success", "data": {"replies_queued": 4, "dm_leads": 2}},
    "scale":    {"status": "success", "data": {"winners": 3, "top_3": [...]}}
  }
}

Money-Making Overview

Buyer Persona:

• SME owners (3-50 employees) in Indonesia/US who need daily social media content without hiring a team
• Digital agencies that want to white-label content production under their own brand
• E-commerce brands that need product content across TikTok, Instagram, Facebook with direct attribution
• Solo creators who need to scale output without burning out

Three Pricing Tiers:

First-Dollar Timeline:

• Day 1: Onboard client, define personas + products (30-min call)
• Day 3: First 5 posts delivered as proof-of-work
• Day 7: Full pipeline running, first engagement data
• Day 14: First optimization cycle, client sees measurable lift
• Day 30: Renewal conversation backed by performance report

Target Markets:

• Indonesia SMEs: Bundle with LYNK affiliate products, Rp 5-15M/mo
• US Agencies: White-label Content Kingdom for $3-7K/mo retainer
• E-commerce Brands: Product-focused content with direct conversion attribution

First Action in 60 Minutes

Copy-paste this to onboard a new client and run their first full pipeline:

#!/usr/bin/env bash
# Content Kingdom Client Onboarder
# Usage: ./onboard_client.sh "ClientName" "ProductName" "Hook Text" "Rp 49K"

set -e
CLIENT="$1"
PRODUCT="$2"
HOOK="$3"
PRICE="$4"

echo "=== Onboarding $CLIENT ==="

# 1. Create scoped client config
mkdir -p "clients/$CLIENT"
cat > "clients/$CLIENT/config.json" << 'EOF'
{
  "products": [{"name": "PLACEHOLDER_PRODUCT", "hook": "PLACEHOLDER_HOOK", "price": "PLACEHOLDER_PRICE"}],
  "personas": ["professional", "trendy"],
  "platforms": {
    "tiktok": {"enabled": true, "schedule": ["07:00", "19:00"]},
    "instagram": {"enabled": true, "schedule": ["08:00", "20:00"]},
    "facebook": {"enabled": true, "schedule": ["12:00"]}
  },
  "quality_gates": {"min_caption_length": 80, "min_image_score": 0.6},
  "scoring_weights": {"views": 1.0, "likes": 2.0, "shares": 10.0, "comments": 5.0},
  "winner_thresholds": {"tiktok": 2000, "instagram": 1500}
}
EOF

sed -i "s/PLACEHOLDER_PRODUCT/$PRODUCT/g" "clients/$CLIENT/config.json"
sed -i "s/PLACEHOLDER_HOOK/$HOOK/g" "clients/$CLIENT/config.json"
sed -i "s/PLACEHOLDER_PRICE/$PRICE/g" "clients/$CLIENT/config.json"

# 2. Run research + plan phases (fast, generates first strategy)
python3 orchestrator.py --phase research --config "clients/$CLIENT/config.json" 2>&1 | tail -5
python3 orchestrator.py --phase plan --config "clients/$CLIENT/config.json" 2>&1 | tail -5

echo ""
echo "=== CLIENT ONBOARDED: $CLIENT ==="
echo "Config: clients/$CLIENT/config.json"
echo "Research: output/research_*.json (review with client)"
echo ""
echo "NEXT: python3 orchestrator.py --phase script --config clients/$CLIENT/config.json"
echo "THEN: python3 orchestrator.py --phase create --config clients/$CLIENT/config.json"
echo "DELIVER: first 5 assets ready after 'create' phase"

What this gets you in 60 minutes:

• Client-specific config created and filled
• Research phase complete (trending angles + competitor analysis)
• Plan phase complete (posting schedule + content strategy)
• Deliverable preview ready to share with client

Deliverable Format

Weekly Content Production Report (deliver every Monday morning):

CONTENT PRODUCTION REPORT
Client: [Name] | Week: 2026-07-20
Pipeline Run ID: run_20260720_080000

=== DELIVERED THIS WEEK ===
Platform   | Posts | Format     | Status
TikTok     | 10    | 9:16 video | Posted
Instagram  | 10    | 4:5 image  | Posted
Facebook   | 5     | 1:1 image  | Scheduled
Total: 25 posts across 3 platforms

=== PERFORMANCE ===
Metric          | Value   | vs Last Week
Engagement Rate | 4.2%    | +0.8%
Total Views     | 45,200  | +12%
Link Clicks     | 1,230   | +5%
Conversions     | 28      | +40%  <- from optimized CTAs

=== TOP 3 PERFORMERS ===
1. "Bisa Cuan Rp 1 Juta/Hari?" — TikTok — 12,400 views, 5.1% eng.
2. Product demo video — Instagram — 8,200 views, 4.8% eng.
3. Testimonial graphic — Facebook — 5,100 views, 3.9% eng.

=== NEXT WEEK PLAN ===
- 5 A/B test variants for low-performing creatives
- 2 new product angles from viral research
- Repurpose top 3 posts into Shorts/reels

=== INVOICE ===
Service: Content Pro — $2,500
Status: Due upon receipt

Pricing Table for Proposals:

┌──────────────────────────────────────────────────────────────────────────┐
│                    CONTENT KINGDOM PRICING                               │
├──────────────┬──────────┬───────────┬──────────────┬─────────────────────┤
│ Service      │ Starter  │ Pro       │ Kingdom      │ À La Carte          │
├──────────────┼──────────┼───────────┼──────────────┼─────────────────────┤
│ Posts/week   │ 10       │ 20        │ 35+          │ $50/post            │
│ Platforms    │ 2        │ 4         │ 6+           │ $100/platform       │
│ Visual Type  │ Template │ Custom    │ Veris Pro    │ $200/design         │
│ Research     │ Basic    │ Viral     │ Full 12-ph   │ $500/research cycle │
│ Engagement   │ --       │ Auto-reply│ Full + DM    │ $300/mo             │
│ Analytics    │ Weekly   │ Weekly +  │ Daily + Opt  │ $200/mo             │
│ Repurposing  │ --       │ --        │ Auto-clip    │ $250/mo             │
├──────────────┼──────────┼───────────┼──────────────┼─────────────────────┤
│ Price/Month  │ $1,000   │ $2,500    │ $5,000       │ Custom              │
└──────────────┴──────────┴───────────┴──────────────┴─────────────────────┘

Invoice Line Items (copy into Stripe/Paddle):

• "Content Kingdom — [Tier] — [Month] — $X,XXX"
• "Content Kingdom — À La Carte — [Qty]x [Service] — $XXX"
• "Content Kingdom — Rush Production — [Posts]x — $XXX"

Anti-Rationalization Table