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 |
| LinkedIn |
3000 |
REST v2 |
Tue-Thu 8-10am |
| Facebook |
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, formatsreferences/posting-best-practices.md - Optimal posting strategiesreferences/thread-templates.md - Thread/carousel templatesreferences/engagement-templates.md - Engagement reply templatesreferences/hook-writing.md - Hook formulas for attention
API Workflows
references/x-twitter-workflow.md - X posting, threads, OAuth 1.0areferences/linkedin-workflow.md - Personal, company pages, PDF carouselsreferences/facebook-workflow.md - Pages, Reels, schedulingreferences/threads-workflow.md - Carousel, reply threadsreferences/tiktok-workflow.md - Video/photo postingreferences/youtube-workflow.md - Video upload, thumbnailsreferences/rate-limits-errors.md - API limits, retry strategiesreferences/unified-api-services.md - Ayrshare, Late.dev alternatives
Scripts
# 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
# 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 specscampaign-management - Multi-platform campaignscopywriting - High-converting copy
Agent Integration
Primary Agents: social-media-manager, content-creator, community-manager
1---2name: social-media-33description: Social media content, API integrations, scheduling. X, Facebook, Threads, LinkedIn, YouTube, TikTok. OAuth, rate limits, media uploads, engagement, threads.4license: MIT5---6
7# Social Media Skill
8
9Content creation, API integrations, and scheduling for X, Facebook, Threads, LinkedIn, YouTube, TikTok.
10
11## When to Use
12
13- Create social media content (posts, threads, carousels)
14- Implement API posting automation
15- Build scheduling systems
16- Handle OAuth authentication flows
17- Manage media uploads and rate limits
18
19## Quick Reference
20
21| Platform | Max Length | API | Best Times (UTC) |
22|----------|------------|-----|------------------|
23| X/Twitter | 280/4000 | v2 OAuth 1.0a | Tue-Fri 9am-12pm |
24| LinkedIn | 3000 | REST v2 | Tue-Thu 8-10am |
25| Facebook | 63,206 | Graph v20.0 | Mon-Fri 9am-1pm |
26| Threads | 500 | Graph v1.0 | Mon-Fri 11am-2pm |
27| TikTok | 2000 | v2 | Tue-Thu 7-9pm |
28| YouTube | 5000 (desc) | Data v3 | Thu-Sat 2-5pm |
29
30## References
31
32### Content & Strategy
33- `references/platform-specs.md` - Platform character limits, formats
34- `references/posting-best-practices.md` - Optimal posting strategies
35- `references/thread-templates.md` - Thread/carousel templates
36- `references/engagement-templates.md` - Engagement reply templates
37- `references/hook-writing.md` - Hook formulas for attention
38
39### API Workflows
40- `references/x-twitter-workflow.md` - X posting, threads, OAuth 1.0a
41- `references/linkedin-workflow.md` - Personal, company pages, PDF carousels
42- `references/facebook-workflow.md` - Pages, Reels, scheduling
43- `references/threads-workflow.md` - Carousel, reply threads
44- `references/tiktok-workflow.md` - Video/photo posting
45- `references/youtube-workflow.md` - Video upload, thumbnails
46- `references/rate-limits-errors.md` - API limits, retry strategies
47- `references/unified-api-services.md` - Ayrshare, Late.dev alternatives
48
49## Scripts
50
51```bash
52# Validate post content
53node scripts/validate-post-content.js --platform x --content "Your post" --media "img.jpg"
54node scripts/validate-post-content.js --platform x --premium --content "Long premium post..."
55
56# Schedule posts with optimal timing
57node scripts/schedule-post.js --suggest-time --platforms "x,linkedin,tiktok"
58node scripts/schedule-post.js --platforms "x,linkedin" --content "Hello" --time "2026-01-21T10:00:00Z"
59```
60
61## Core Workflows
62
63### Content Creation
641. Define platform and goal
652. Write platform-optimized copy (load `posting-best-practices.md`)
663. Create hook using formulas (load `hook-writing.md`)
674. Add visuals, hashtags
685. Schedule optimal time
69
70### Thread Creation
711. Choose type: educational, story, list, how-to
722. Write hook (most important)
733. Outline 5-15 posts
744. End with CTA
75
76### API Posting
771. Authenticate: OAuth 2.0 (most) or OAuth 1.0a (X)
782. Upload media (chunked for large videos)
793. Validate content via `validate-post-content.js`
804. Create post with media IDs
815. Handle errors with exponential backoff
82
83## Environment Variables
84
85```bash
86# X (Twitter)
87X_API_KEY=
88X_API_SECRET=
89
90# LinkedIn
91LINKEDIN_CLIENT_ID=
92LINKEDIN_CLIENT_SECRET=
93
94# Facebook/Threads (Meta)
95FACEBOOK_APP_ID=
96FACEBOOK_APP_SECRET=
97
98# TikTok
99TIKTOK_CLIENT_ID=
100TIKTOK_CLIENT_SECRET=
101
102# YouTube
103YOUTUBE_CLIENT_ID=
104YOUTUBE_CLIENT_SECRET=
105
106# Unified APIs
107AYRSHARE_API_KEY=
108LATE_API_KEY=
109```
110
111## Best Practices
112
1131. **Content**: Native content > cross-posted
1142. **Timing**: Test posting times for your audience
1153. **Engagement**: Respond within 1 hour
1164. **Tokens**: Refresh before expiry
1175. **Rate Limits**: Exponential backoff (5s, 10s, 20s...)
1186. **Media**: Resize images (<4MB), check video duration
119
120## Related Skills
121
122- `video-production` - Video content specs
123- `campaign-management` - Multi-platform campaigns
124- `copywriting` - High-converting copy
125
126## Agent Integration
127
128**Primary Agents:** social-media-manager, content-creator, community-manager
majiayu000