Social Media Skill
Content creation, API integrations, and scheduling for X, Facebook, Threads, LinkedIn, YouTube, TikTok.
When to Use
- •Create social media content (posts, threads, carousels)
- •Implement API posting automation
- •Build scheduling systems
- •Handle OAuth authentication flows
- •Manage media uploads and rate limits
Quick Reference
| Platform | Max Length | API | Best Times (UTC) |
|---|---|---|---|
| X/Twitter | 280/4000 | v2 OAuth 1.0a | Tue-Fri 9am-12pm |
| 3000 | REST v2 | Tue-Thu 8-10am | |
| 63,206 | Graph v20.0 | Mon-Fri 9am-1pm | |
| Threads | 500 | Graph v1.0 | Mon-Fri 11am-2pm |
| TikTok | 2000 | v2 | Tue-Thu 7-9pm |
| YouTube | 5000 (desc) | Data v3 | Thu-Sat 2-5pm |
References
Content & Strategy
- •
references/platform-specs.md- Platform character limits, formats - •
references/posting-best-practices.md- Optimal posting strategies - •
references/thread-templates.md- Thread/carousel templates - •
references/engagement-templates.md- Engagement reply templates - •
references/hook-writing.md- Hook formulas for attention
API Workflows
- •
references/x-twitter-workflow.md- X posting, threads, OAuth 1.0a - •
references/linkedin-workflow.md- Personal, company pages, PDF carousels - •
references/facebook-workflow.md- Pages, Reels, scheduling - •
references/threads-workflow.md- Carousel, reply threads - •
references/tiktok-workflow.md- Video/photo posting - •
references/youtube-workflow.md- Video upload, thumbnails - •
references/rate-limits-errors.md- API limits, retry strategies - •
references/unified-api-services.md- Ayrshare, Late.dev alternatives
Scripts
bash
# Validate post content node scripts/validate-post-content.js --platform x --content "Your post" --media "img.jpg" node scripts/validate-post-content.js --platform x --premium --content "Long premium post..." # Schedule posts with optimal timing node scripts/schedule-post.js --suggest-time --platforms "x,linkedin,tiktok" node scripts/schedule-post.js --platforms "x,linkedin" --content "Hello" --time "2026-01-21T10:00:00Z"
Core Workflows
Content Creation
- •Define platform and goal
- •Write platform-optimized copy (load
posting-best-practices.md) - •Create hook using formulas (load
hook-writing.md) - •Add visuals, hashtags
- •Schedule optimal time
Thread Creation
- •Choose type: educational, story, list, how-to
- •Write hook (most important)
- •Outline 5-15 posts
- •End with CTA
API Posting
- •Authenticate: OAuth 2.0 (most) or OAuth 1.0a (X)
- •Upload media (chunked for large videos)
- •Validate content via
validate-post-content.js - •Create post with media IDs
- •Handle errors with exponential backoff
Environment Variables
bash
# X (Twitter) X_API_KEY= X_API_SECRET= # LinkedIn LINKEDIN_CLIENT_ID= LINKEDIN_CLIENT_SECRET= # Facebook/Threads (Meta) FACEBOOK_APP_ID= FACEBOOK_APP_SECRET= # TikTok TIKTOK_CLIENT_ID= TIKTOK_CLIENT_SECRET= # YouTube YOUTUBE_CLIENT_ID= YOUTUBE_CLIENT_SECRET= # Unified APIs AYRSHARE_API_KEY= LATE_API_KEY=
Best Practices
- •Content: Native content > cross-posted
- •Timing: Test posting times for your audience
- •Engagement: Respond within 1 hour
- •Tokens: Refresh before expiry
- •Rate Limits: Exponential backoff (5s, 10s, 20s...)
- •Media: Resize images (<4MB), check video duration
Related Skills
- •
video-production- Video content specs - •
campaign-management- Multi-platform campaigns - •
copywriting- High-converting copy
Agent Integration
Primary Agents: social-media-manager, content-creator, community-manager