kai-social

name

kai-social

description

Plan and batch-produce social media content across platforms (Instagram, X/Twitter, TikTok, LinkedIn, YouTube). Generates a week or month of posts with platform-specific formatting, hashtags, hooks, and posting schedule. Use when "social media posts", "social calendar", "plan social content", "Instagram posts", "tweets", "LinkedIn posts", "TikTok ideas", "social media strategy", "batch social", or any request to systematically produce social media content.

Plan and batch-produce social media content across platforms with platform-specific optimization.

Phase 0: Load Product Context

Check if MARKETING.md exists in the project root (same directory as CLAUDE.md, README.md, package.json).

If it exists: Read it — skip product discovery questions. It has the product name, ICP, value prop, monetization, brand voice, current channels, and competitive landscape.

If it does NOT exist: Auto-explore the codebase to create it in the project root (next to CLAUDE.md). Do NOT ask the user what the product is. Read CLAUDE.md, README.md, PROJECT.md, package.json, landing pages, and any project files. Search for email/ad/analytics config. Then create MARKETING.md using the template from /kai-email-system. Present draft to user for confirmation.

---

Phase 1: Social Discovery

Read from MARKETING.md. Only ask about things not covered there:

1. Brand/product — what are we posting about?
2. Platforms — which ones? (Instagram, X, TikTok, LinkedIn, YouTube)
3. Time horizon — 1 week or 1 month?
4. Posting cadence — how often per platform?
5. Content pillars — what themes/topics? (educational, behind-the-scenes, product, social proof, culture)
6. Tone — professional, casual, bold, irreverent?
7. Existing content — any blog posts, videos, or assets to repurpose?

Phase 2: Social Calendar

Load these before planning:

• knowledge/playbooks/social-media-strategy.md
• Platform-specific channels as needed:
  • knowledge/channels/instagram.md
  • knowledge/channels/x-twitter.md
  • knowledge/channels/tiktok-algorithm.md
  • knowledge/channels/youtube.md
  • knowledge/channels/linkedin-articles.md

Generate workspace/social/_calendar.md:

Day	Platform	Pillar	Format	Hook	Status
Mon	LinkedIn	Educational	Text post	Insight/contrarian take	Draft
Mon	X	Product	Thread	Problem → solution	Draft
Tue	Instagram	Social proof	Carousel	Customer result	Draft
Tue	TikTok	Educational	Short video script	Hook question	Draft
...	...	...	...	...	...

Content Pillar Mix

Recommend a balanced mix:

• 40% Value/Educational — teach something useful
• 25% Social Proof — results, testimonials, case studies
• 20% Product — features, demos, tutorials
• 15% Culture/BTS — team, process, behind-the-scenes

Approval Gate

Present calendar before producing posts.

Phase 3: Batch Production

Platform-Specific Formats

LinkedIn:

• Hook line (pattern interrupt or bold claim)
• 3-5 short paragraphs
• Line breaks between every thought
• CTA at the end
• 1200-1500 chars optimal

X/Twitter:

• Single tweets: max 280 chars, front-load the hook
• Threads: 3-7 tweets, each standalone valuable, numbered
• End thread with CTA or summary

Instagram:

• Captions: hook in first line (before "...more"), 150-300 words
• Carousel: 5-10 slides, one idea per slide, bold text
• Reels: script format (hook in first 3 seconds)

TikTok:

• Hook in first 2 seconds (question, bold claim, or visual pattern interrupt)
• 15-60 second script
• Trending format adaptation
• CTA as last frame

YouTube:

• Shorts: 30-60 second script, hook-first
• Community posts: poll or discussion question

Per-Post Output

# [Platform] — [Day] — [Pillar]

> **Kai root note:** `knowledge/`, `harness/`, and `scripts/` paths in this skill live in the Kai install, not the user's project. Resolve them against the first ancestor directory of this SKILL.md that contains a `knowledge/` folder (the Kai plugin root, `~/.claude/kai`, or the kai-cmo-harness repo). `MARKETING.md`, `memory/`, and any output files live in the current project. If a referenced `scripts/` command is not available in this install, say so, skip it, and continue with the file-based guidance — never fabricate its output.

**Format:** [text/carousel/thread/video script]
**Hook:** [first line or first 3 seconds]

## Copy
[Full post text]

## Hashtags (if applicable)
[platform-appropriate hashtags]

## Visual Direction (if applicable)
[Brief description of image/carousel/video]

## Posting Notes
- Best time: [time]
- Cross-post to: [other platforms, if adapted]

Quality Gates (per post)

1. Hook in first line (no warm-up, no preamble)
2. Zero banned words
3. Zero AI slop
4. Platform character limits respected
5. Single CTA (or no CTA for pure value posts)
6. Not generic — could only come from THIS brand

Phase 4: Output

workspace/social/
├── _calendar.md
├── linkedin/
│   ├── mon-educational.md
│   ├── wed-social-proof.md
│   └── ...
├── x-twitter/
│   └── ...
├── instagram/
│   └── ...
├── tiktok/
│   └── ...
└── _quality-report.md