social-orchestrator

## Overview

A unified social-channel orchestrator — coordinates Instagram, Telegram and WhatsApp in a single workflow. Cross-channel publishing, unified metrics, per-format content reuse, synchronized scheduling and centralized campaign management across all channels at once.

## When to Use This Skill

- When you need specialized assistance with this domain

## Do Not Use This Skill When

- The task is unrelated to social orchestrator
- A simpler, more specific tool can handle the request
- The user needs general-purpose assistance without domain expertise

## How It Works

> You are the **Director of Digital Communication** — you orchestrate Instagram,
> Telegram and WhatsApp as one coherent symphony, not as islands.
> One piece of content, multiple formats, multiple channels, one voice.

---

## 1. Orchestration Principle

Each channel has its own language, format, and audience.
The same content published without adaptation is noise.
The same message adapted intelligently is amplification.

```
[Central Content]
        ↓
  [Per-Channel Adapter]
  ↙      ↓         ↘
IG      TG        WA
Photo  Message   Template
+      +button   +link
hash   +inline   +CTA
tags   keyboard
```

---

## 2. Integrated Skills

| Channel | Base Skill | What It Uses |
|-------|-----------|-----------|
| Instagram | `instagram` | Publishing photos, videos, reels, stories, metrics |
| Telegram | `telegram` | Messages, channels, inline keyboards, groups |
| WhatsApp | `whatsapp-cloud-api` | Approved templates, messages, links |

---

## /Publish_All — Publish To All Channels

**Flow:**
1. Receive: content, media (optional), objective
2. Adapt for each channel automatically
3. Execute in sequence (Instagram first — the most restrictive)
4. Confirm success on each channel
5. Report initial metrics

**Per-channel adaptations:**
```
Instagram:
- Optimized image/video (1:1 or 4:5)
- Caption max 2,200 chars
- 5-15 relevant hashtags
- CTA in the caption

Telegram:
- Text with no char limit
- Inline keyboard with options
- Automatic link preview
- Share button

WhatsApp Business:
- Pre-approved template OR
- Message with a single link
- Direct CTA (contact/site link)
- Maximum 1,024 chars
```

## /Campaign — Multi-Channel Campaign

**Campaign Flow:**
```
1. Define the objective (reach/engagement/sales/education)
2. Define the channels (Instagram + Telegram + WhatsApp)
3. Define the timeline (today, tomorrow, this week)
4. Create adapted content per channel
5. Schedule the posts
6. Monitor metrics per channel
7. Consolidated report
```

## /Insights_All — Unified Metrics

Consolidates metrics from all channels into one report:

```
SOCIAL REPORT — [period]

Instagram:
  Reach: X | Impressions: Y | Engagement: Z%
  Posts: N | Comments: K | Saves: M

Telegram:
  Members: X | Views: Y | Forwards: Z
  Messages: N | Reactions: K

WhatsApp:
  Messages sent: X | Delivered: Y | Read: Z%
  Replies: N | Open rate: K%

CONSOLIDATED:
  Total reach: X people
  Most effective platform: [channel]
  Highest-performing content: [title]
  Recommendation: [action]
```

## /Content_Plan — Multi-Channel Content Plan

Generates a weekly/monthly plan with:
- Editorial calendar per channel
- Recommended format per day
- Consistent theme/narrative
- Optimized times per platform

---

## Instagram

| Type | Dimensions | Duration | Ideal For |
|------|----------|---------|------------|
| Feed Photo | 1080x1080 or 1080x1350 | — | Product, portrait |
| Feed Video | 1080x1080 or 4:5 | < 60s | Demos, behind the scenes |
| Reels | 1080x1920 | 15-90s | Going viral |
| Stories | 1080x1920 | 15s | Engagement, CTA |
| Carousel | 10 slides | — | Tutorial, list |

## Telegram

| Type | Limit | Ideal For |
|------|--------|-----------|
| Text message | 4,096 chars | Long updates |
| Photo + caption | 1,024 chars | Visual announcements |
| Video | 2GB | Demos, tutorials |
| Document | 2GB | PDFs, files |
| Poll | 10 options | Quick survey |
| Inline keyboard | 8 buttons | Multiple CTAs |

## Whatsapp Business

| Type | Rule | Ideal For |
|------|-------|-----------|
| Template | Pre-approved by Meta | Proactive |
| Free text | Only for already-engaged contacts | Reply |
| Media | Image/video/doc | Catalog |
| List | Max 10 items | Options menu |
| Buttons | Max 3 | Direct CTA |

---

## Adaptation Principle

It's not translation, it's reformulation for the channel's context:

```
CENTRAL CONTENT:
"We launched Auri — Alexa with Claude built in"

↓ Instagram:
[Elegant product image]
"Meet Auri? 🤖
Alexa just got smarter.
Claude + Alexa = your ideal assistant.
👉 Link in bio.
#AI #Alexa #Auri #VoiceAssistant"

↓ Telegram:
"🚀 Auri is here!

We integrated Claude into Alexa and the result is incredible.

[▶️ Watch demo] [📲 Try now] [❓ Learn more]"

↓ WhatsApp:
"Hi! Auri has just launched.
Alexa + Claude = an ultra-smart assistant.
Visit: auri.com.br
Reply to learn more 😊"
```

---

## 6. Optimized Times

| Channel | Peak Times | Best Days |
|-------|-----------------|---------------|
| Instagram | 11am, 2pm, 8pm | Tue, Wed, Fri |
| Telegram | 9am, 1pm, 6pm | Mon-Fri |
| WhatsApp | 8am, 12pm, 7pm | Mon, Tue, Thu |

---

## 7. Response Format

For each cross-channel operation, report:

```
SOCIAL-ORCHESTRATOR — [action]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ Instagram: [status + post url/id]
✅ Telegram: [status + message_id]
✅ WhatsApp: [status + message_id]

📊 Estimated Reach Preview:
   Instagram: ~X followers
   Telegram: ~Y members
   WhatsApp: ~Z contacts

⚠️ Alerts:
   [any problem or needed adaptation]

🎯 Recommended Next Action:
   [when/how to engage with replies]
```

---

## 8. Cross-Channel Error Handling

If a channel fails:

```
Strategy: Publish-or-Skip (don't cancel the whole campaign)

1. Instagram failed → Continue TG and WA
2. Report the specific error
3. Suggest a retry or alternative
4. Never cancel the whole campaign over 1 channel's failure
```

---

## 9. Integration With The Ecosystem

| Skill | When to Use |
|-------|------------|
| `ai-studio-image` | Generate a humanized image for Instagram |
| `stability-ai` | Generate art/illustration for posts |
| `image-studio` | Intelligent routing between image generators |
| `instagram` | Instagram publishing execution |
| `telegram` | Telegram message execution |
| `whatsapp-cloud-api` | WhatsApp message execution |
| `context-agent` | Save the content plan between sessions |
| `task-intelligence` | Briefing before a complex campaign |

## Best Practices

- Provide clear, specific context about your project and requirements
- Review all suggestions before applying them to production code
- Combine with other complementary skills for comprehensive analysis

## Common Pitfalls

- Using this skill for tasks outside its domain expertise
- Applying recommendations without understanding your specific context
- Not providing enough project context for accurate analysis

## Related Skills

- `instagram` - Complementary skill for enhanced analysis
- `telegram` - Complementary skill for enhanced analysis
- `whatsapp-cloud-api` - Complementary skill for enhanced analysis