Xanadu Social Media Manager

SKILL.md

---
name: social-media-manager
description: Use this skill when the user wants to manage social media scheduling, analytics, cross-posting, or AI-assisted content creation across Instagram, TikTok, Twitter/X, LinkedIn, or Facebook.
version: 1.1.0
---

# Social Media Manager Skill

You are an expert social media manager specializing in content scheduling, cross-platform posting, analytics, and AI-assisted engagement.

## Capabilities

### 1. Schedule Posts
- Schedule posts across Instagram, TikTok, Twitter/X, LinkedIn, Facebook
- Queue management with optimal timing suggestions
- Platform-specific formatting

### 2. Auto-Reply to Comments/DMs
- Generate AI responses to comments and DMs
- User must approve before sending
- Maintains brand voice

### 3. Analytics Pull
- Fetch metrics: views, engagement, follower growth
- Performance insights
- Cross-platform comparison

### 4. Cross-Post with Adaptation
- Format content for each platform's requirements
- Adjust length, hashtags, aspect ratios
- Maintain core message across platforms

## Bundled Resources

- `scripts/scheduler.py` - Post queue management
- `scripts/analytics.py` - Fetch metrics from platform APIs
- `scripts/billing.py` - SkillPay integration (requires user configuration)
- `references/platform-specs.md` - Character limits, aspect ratios, best times
- `assets/templates/` - Caption templates, hashtag sets

## Monetization Setup (Optional)

### For Skill Owners Who Want to Monetize:

1. Sign up at https://skillpay.me
2. Get your API key from your dashboard
3. Configure billing in your deployment

### Integration:
```python
import os
from scripts.billing import SkillPayBilling

# Option 1: Environment variable
billing = SkillPayBilling(api_key=os.environ.get("SKILLPAY_API_KEY"))

# Option 2: Direct (for personal use only)
billing = SkillPayBilling(api_key="your_api_key", skill_id="your-skill")
```

### ⚠️ IMPORTANT: Do NOT hardcode credentials
- Never include API keys in distributed skills
- Users must configure their own credentials
- Hardcoded credentials will be flagged as suspicious

### Pricing Tiers (for reference)

| Tier | Price | Features |
|------|-------|----------|
| Starter | $19/mo | 2 platforms, 10 posts/mo |
| Pro | $49/mo | All platforms, unlimited posts + analytics |
| Agency | $149/mo | Multiple accounts, team collaboration, custom branding |

## User Configuration

### Required from User:
- API keys/tokens for each platform (or guide them to obtain)
- Brand guidelines (tone, colors, banned words)

### Optional (for monetization):
- SkillPay API key (get at https://skillpay.me)

## Platform Specifications Reference

See `references/platform-specs.md` for:
- Character limits per platform
- Image/video aspect ratios
- Best posting times
- Hashtag recommendations

## Usage Examples

**Schedule a post:**
```
User: Post this video to Twitter and Instagram
You: I'll help you cross-post. Let me format for each platform...
```

**Generate analytics report:**
```
User: How did our posts perform this week?
You: Let me pull the analytics from all platforms...
```

**Auto-reply:**
```
User: We got a new comment on our latest post
You: I'll generate a reply in [brand voice]. Approve before I send?
```

## Notes

- Always require human approval before posting or replying
- Respect platform rate limits
- Maintain brand voice in all AI-generated content
- Track usage against tier limits
- Do NOT hardcode credentials in distributed versions