Social Media Skills

The Decision

Social Media Skills is a collection of 15 agent skills that cover the entire social media workflow: strategy, creation, repurposing, and analytics. Each skill handles one job — post writing, thread creation, carousel scripting, hook optimization, performance analysis — and they compose together into a complete social media engine.

It replaces Buffer, Copy.ai, and SparkToro for content creation and strategy, while optionally integrating with BlackTwist for direct publishing.

Our testing rates it 9.0/10 overall. The skill package works within Claude Code, Cursor, and any MCP-compatible agent. MIT licensed and free for commercial use.

Who It’s For

• Solo creators managing 2+ social platforms
• Content teams needing consistent brand voice across channels
• Growth hackers optimizing post performance with data
• Anyone repurposing blog/video/podcast content across social channels

Who Should Skip

• Single-platform creators who don’t cross-post
• Teams needing full social management (inbox, approvals, team workflows)

Why This Skill Matters

Most social media tools solve one piece of the puzzle — scheduling (Buffer), copywriting (Copy.ai), or analytics (Sprout Social). This skill package gives you the entire pipeline as Agent skills: define your strategy once, create platform-optimized content, repurpose across networks, and analyze what works. The Agent understands each platform’s algorithm and format requirements, so a LinkedIn post, a Twitter thread, and an Instagram caption all get platform-specific treatment from the same source material.

The Full Skill Catalog

Strategy Layer

Creation Layer

Analysis Layer

The Workflow

1. Define Context
   social-media-context-sms
   → Captures: brand voice, audience, platforms, content pillars
   → Output: context profile used by all other skills
        |
        v
2. Build Strategy
   content-strategy-sms + platform-strategy-sms
   → Defines: positioning, themes, platform-specific approaches
   → Output: strategy document
        |
        v
3. Plan Calendar
   content-calendar-sms
   → Plans: posting schedule, themes per week
   → Output: 4-week content calendar
        |
        v
4. Create Content
   post-writer-sms / thread-writer-sms / carousel-writer-sms / caption-writer-sms
   → Writes: platform-optimized content for each scheduled slot
   → Each skill applies platform-specific formatting and hooks
        |
        v
5. Repurpose
   content-repurposer-sms
   → Transforms: blog → thread → carousel → captions → newsletter snippet
   → One source piece → 5+ distribution assets
        |
        v
6. Analyze & Optimize
   performance-analyzer-sms → optimization-advisor-sms
   → Surfaces: what worked, what to change, posting time recommendations
   → Output: action items for next cycle

Core Features

1. Post Writer (post-writer-sms)
   Writes standalone posts optimized for each platform’s format and audience. LinkedIn posts get professional tone and industry hooks. Twitter posts get punchy language and thread-ready structure. Instagram captions get emoji patterns and hashtag suggestions. Verdict: excellent.

2. Thread Writer (thread-writer-sms)
   Creates multi-post threads with a strong opening hook, clear narrative arc, and consistent pacing. Works across Twitter/X, LinkedIn, and Threads. Verdict: excellent.

3. Hook Writer (hook-writer-sms)
   Crafts the most critical element of any post — the opening line. Uses platform-specific patterns: curiosity gaps for Twitter, professional credibility for LinkedIn, visual teasers for Instagram. Verdict: excellent.

4. Content Repurposer (content-repurposer-sms)
   Transforms one piece of content into multiple formats for different platforms. A blog post becomes a Twitter thread, LinkedIn carousel, Instagram caption set, and newsletter snippet — each platform-native. Verdict: excellent.

5. Performance Analyzer (performance-analyzer-sms)
   Interprets post metrics and account data to surface what’s working. Goes beyond raw numbers to identify patterns: which topics resonate, which formats drive engagement, which posting times perform best. Verdict: great.

6. Content Calendar (content-calendar-sms)
   Plans publishing cadence, themes, and scheduling across all connected platforms. Maintains a consistent rhythm without burnout. Verdict: great.

Hands-On

Install all 15 skills:

npx skills add blacktwist/social-media-skills

Install specific skills only:

npx skills add blacktwist/social-media-skills --skill post-writer-sms hook-writer-sms content-repurposer-sms

Clone alternative:

git clone https://github.com/blacktwist/social-media-skills.git
cp -r social-media-skills/skills/* .agents/skills/

First-time setup — Define your brand context:

Using social-media-context-sms, set up my brand profile:
- Platform: LinkedIn, Twitter/X, Instagram
- Audience: B2B SaaS founders, 25-45
- Voice: authoritative but approachable
- Content pillars: AI tools, startup growth, creator economy
- Goal: 10k followers in 6 months

Create a post:

Using post-writer-sms, write a LinkedIn post about how AI agents are replacing manual social media workflows. Target: B2B SaaS founders. Goal: drive comments and saves.

Repurpose content:

Using content-repurposer-sms, take this blog post and create:
1. A Twitter/X thread (8-12 tweets)
2. A LinkedIn carousel (10 slides)
3. An Instagram caption with hashtags
4. A newsletter intro paragraph

Real-World Case Study: Building a Full Content Engine for a B2B SaaS Brand in One Afternoon

The Challenge

You’re a one-person marketing team for a B2B SaaS startup. You need to:

• Publish 3 LinkedIn posts/week, 5 Twitter/X tweets/day, 2 Instagram carousels/week
• Repurpose every blog post into 4+ platform-specific formats
• Maintain a consistent brand voice across all channels
• Track what’s working and double down on high-performing topics

Manual content creation takes 15+ hours/week. Goal: cut that to under 3 hours using Agent-assisted workflows.

The Prompt Chain (Exact Steps)

1. Set Up Brand Context (One-Time)

   Using social-media-context-sms, set up my brand profile:
   - Platform: LinkedIn, Twitter/X, Instagram
   - Audience: B2B SaaS founders, 25-45
   - Voice: authoritative but approachable, data-driven
   - Content pillars: AI tools, startup growth, creator economy
   - Competitors: Notion, Linear, Vercel
   - Goal: 10k followers in 6 months

   Agent output: Brand context JSON stored in .agents/brand-context.json. All downstream skills reference this automatically.

2. Repurpose a Blog Post into Multi-Platform Content

   Using content-repurposer-sms, take this blog post about AI agent workflows and create:
   1. A Twitter/X thread (8-12 tweets, with hooks and CTAs)
   2. A LinkedIn long-form post (1200-1500 words, with bold sections)
   3. An Instagram carousel script (10 slides, minimal text per slide)
   4. A newsletter intro paragraph

   Agent output: Four separate content blocks, each formatted for its target platform. The Twitter thread includes numbered tweets with engagement hooks. The LinkedIn post has paragraph breaks optimized for the feed algorithm.

3. Write a Standalone LinkedIn Post

   Using post-writer-sms, write a LinkedIn post about how AI agents are replacing manual social media workflows.
   - Target: B2B SaaS founders
   - Goal: drive comments and saves
   - Include a specific data point or statistic
   - End with a question to boost engagement

   Agent output: A polished LinkedIn post with hook → story → insight → CTA structure. Includes a performance prediction based on the brand context.

4. Generate Hooks for A/B Testing

   Using hook-writer-sms, generate 5 alternative hooks for the LinkedIn post above.
   Mix styles: question-based, controversial statement, data-driven, story-opening, counter-intuitive.

   Agent output: Five hook options, each with a brief rationale for why it should work with the target audience.

5. Plan the Content Calendar

   Using content-calendar-sms, plan next week's publishing schedule:
   - 3 LinkedIn posts (Tue, Wed, Thu at 8am)
   - 5 Twitter/X tweets (Mon-Fri, 2 per day at 9am and 2pm)
   - 2 Instagram carousels (Wed, Sat)
   - Schedule around the product launch on Thursday

   Agent output: A structured calendar with time slots, content assignments, and cross-promotion notes.

6. Analyze Performance (Weekly)

   Using performance-analyzer-sms, analyze last week's LinkedIn posts.
   Focus on: which topics got the most comments, which hooks drove saves, optimal posting times.

   Agent output: A summary showing engagement patterns, with recommendations like “Data-driven posts outperform story posts 2:1 — prioritize stats-heavy content next week.”

The Result

• Before: 15+ hours/week creating and scheduling content manually
• After: ~3 hours/week reviewing Agent outputs and giving feedback
• Content output: 3 LinkedIn + 5 Twitter + 2 Instagram pieces per week (consistent cadence)
• Quality: Brand voice stays consistent across platforms because the context skill enforces tone guidelines
• Iteration speed: A single blog post becomes 4 platform-specific pieces in under 5 minutes

Key Takeaways for Prompt Engineering

• Set brand context once, reuse everywhere: The context skill eliminates repetitive brand-description prompts.
• Use content-repurposer-sms as the multiplier: One piece of long-form content becomes 4+ short-form pieces automatically.
• Request hooks separately for A/B testing: The hook-writer skill generates variants that you’d never think of yourself.
• Performance analysis closes the loop: Weekly reviews inform next week’s content strategy without manual spreadsheet tracking.
• Platform-specific formatting matters: LinkedIn paragraphs ≠ Twitter threads ≠ Instagram captions. The skills handle this automatically.

This workflow turns a solo creator into a full content team — one blog post feeds the entire week’s social presence.

Pricing

Free (MIT License) — All 15 skills included. No usage limits.

Optional: BlackTwist MCP adds direct publishing, analytics fetching, and scheduling. Free tier available.

Verdict: 9.0/10

Social Media Skills is the most complete open-source social media toolkit for Agent-based workflows. The skill-per-function design means each piece does one job well, and they compose into a full content engine. The cross-platform repurposing alone saves hours per week. For creators managing multiple platforms, this is the single most impactful skill package available. Pair it with BlackTwist MCP for direct publishing, and you have a social media team in your terminal.

Try It

npx skills add blacktwist/social-media-skills

Source Code · 268 ⭐ · MIT License

FAQ

Q: Do I need BlackTwist to use these skills?
A: No. Without BlackTwist, skills operate in advisory mode — they generate content and instructions for manual posting. BlackTwist MCP enables direct publishing, analytics, and scheduling from within the Agent.

Q: How do I install only the skills I need?
A: Use npx skills add blacktwist/social-media-skills --skill post-writer-sms hook-writer-sms to install specific skills by name.

Q: Does it support non-English content?
A: Yes. The skills adapt to whatever language you write in. Platform-specific patterns (hook styles, formatting conventions) are universal and work across languages.