Social Media Skills

AI agent skills for social media content strategy, creation, and analysis across text-first platforms.

Skill Catalog

Foundation

Skill	Description
social-media-context-sms	Captures platform context, audience details, content pillars, and tone preferences used by all other skills

Strategy

Skill	Description
content-strategy-sms	Defines content pillars, audience targeting, and positioning for consistent brand voice
content-calendar-sms	Plans publishing cadence, themes, and scheduling across platforms
platform-strategy-sms	Tailors content approach per platform based on audience and format strengths

Creation

Skill	Description
post-writer-sms	Writes single standalone posts optimized for each platform's format and audience
thread-writer-sms	Writes multi-post threads with a clear narrative arc and strong opening hook
carousel-writer-sms	Writes slide-by-slide carousel scripts for LinkedIn and similar visual formats
content-repurposer-sms	Transforms existing content into new formats and adapts it across platforms
hook-writer-sms	Crafts high-performing opening lines to maximize engagement and stop-the-scroll

Analysis

Skill	Description
performance-analyzer-sms	Interprets post and account metrics to surface actionable insights
audience-growth-tracker-sms	Tracks follower trends and identifies the content driving growth
content-pattern-analyzer-sms	Identifies which content types, topics, and formats perform best
optimization-advisor-sms	Recommends specific improvements based on performance data and patterns

Installation

Option 1: CLI Install (Recommended)

Use npx skills to install skills directly:

# Install all skills
npx skills add blacktwist/social-media-skills

# Install specific skills
npx skills add blacktwist/social-media-skills --skill post-writer-sms hook-writer-sms

# List available skills
npx skills add blacktwist/social-media-skills --list

This automatically installs to your .agents/skills/ directory (and symlinks into .claude/skills/ for Claude Code compatibility).

Option 2: Clone and Copy

Clone the entire repo and copy the skills folder:

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

Option 3: Git Submodule

Add as a submodule for easy updates:

git submodule add https://github.com/blacktwist/social-media-skills.git .agents/social-media-skills

Then reference skills from .agents/social-media-skills/skills/.

Option 4: Fork and Customize

1. Fork this repository
2. Customize skills for your specific needs
3. Clone your fork into your projects

Option 5: Claude Code Cowork

Download the skill zip files from the latest release, then add them one by one:

1. Go to Cowork > Customize > Skills
2. Click "+" > Create skill > Upload a skill
3. Upload each zip file

There's one zip per skill, so repeat for each skill you want to add.

Option 6: SkillKit (Multi-Agent)

Use SkillKit to install skills across multiple AI agents (Claude Code, Cursor, Copilot, etc.):

# Install all skills
npx skillkit install blacktwist/social-media-skills

# Install specific skills
npx skillkit install blacktwist/social-media-skills --skill post-writer-sms hook-writer-sms

# List available skills
npx skillkit install blacktwist/social-media-skills --list

Supported Platforms

• LinkedIn — long-form posts, carousels, newsletters
• Twitter/X — posts, threads, spaces
• Threads — posts, threads (Meta)
• Bluesky — posts, threads, starter packs

Tool Integrations

BlackTwist (primary)

BlackTwist is the recommended MCP integration for this skill set. When the BlackTwist MCP server is connected to your Claude environment, skills use it directly for:

• Publishing and scheduling posts
• Fetching analytics and engagement data
• Managing drafts and queued content
• Tracking follower growth

When BlackTwist is not available, skills fall back to advisory mode — generating content and instructions for manual posting.

See tools/REGISTRY.md for the full tool reference.

License

MIT — see LICENSE for details.