Sandbox
@blacktwist/social-media-skills

Social media skills for Claude Code and other agents

This repo bundles AI agent skills for social media strategy, writing, repurposing, and analysis. The skills are organized by foundation, strategy, creation, and analysis, and can connect to BlackTwist for publishing, scheduling, drafts, and analytics.

492 stars80 forksShellUpdated 4mo ago
Who it's for

Builders who use agent tools to plan, write, and analyze social media content across LinkedIn, X, Threads, Bluesky, and similar platforms.

What it delivers

You can turn social media work into reusable agent skills for faster drafting, clearer strategy, and more consistent analysis.

What it does

Foundation context skill

`social-media-context-sms` captures platform context, audience details, content pillars, and tone preferences for the other skills.

Strategy skills

`content-strategy-sms`, `content-calendar-sms`, and `platform-strategy-sms` define pillars, cadence, and platform-specific approaches.

Creation skills

`post-writer-sms`, `thread-writer-sms`, `carousel-writer-sms`, `caption-writer-sms`, `content-repurposer-sms`, and `hook-writer-sms` generate and adapt content for different formats.

Analysis skills

`performance-analyzer-sms`, `audience-growth-tracker-sms`, `content-pattern-analyzer-sms`, and `optimization-advisor-sms` interpret metrics and suggest improvements.

Tool integration

BlackTwist MCP support lets the skills publish, schedule, fetch analytics, manage drafts, and track follower growth when connected.

How to get it

  1. 1Use 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
  2. 2Clone 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/
  3. 3Add as a submodule for easy updates
    git submodule add https://github.com/blacktwist/social-media-skills.git .agents/social-media-skills
  4. 4Use SkillKit to install skills across multiple AI agents (Claude Code, Cursor, Copilot,…
    # 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

README

Social Media Skills

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

Skill Catalog

Foundation

SkillDescription
social-media-context-smsCaptures platform context, audience details, content pillars, and tone preferences used by all other skills

Strategy

SkillDescription
content-strategy-smsDefines content pillars, audience targeting, and positioning for consistent brand voice
content-calendar-smsPlans publishing cadence, themes, and scheduling across platforms
platform-strategy-smsTailors content approach per platform based on audience and format strengths

Creation

SkillDescription
post-writer-smsWrites single standalone posts optimized for each platform's format and audience
thread-writer-smsWrites multi-post threads with a clear narrative arc and strong opening hook
carousel-writer-smsWrites slide-by-slide carousel scripts for LinkedIn and similar visual formats
caption-writer-smsWrites captions for visual-first platforms — Facebook, Instagram, TikTok, Pinterest
content-repurposer-smsTransforms existing content into new formats and adapts it across platforms
hook-writer-smsCrafts high-performing opening lines to maximize engagement and stop-the-scroll

Analysis

SkillDescription
performance-analyzer-smsInterprets post and account metrics to surface actionable insights
audience-growth-tracker-smsTracks follower trends and identifies the content driving growth
content-pattern-analyzer-smsIdentifies which content types, topics, and formats perform best
optimization-advisor-smsRecommends 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

Text-first

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

Visual-first (captions only — see caption-writer-sms)

  • Facebook — feed posts, photo and video captions
  • Instagram — feed, Reels, carousels, stories
  • TikTok — short-form video captions
  • Pinterest — pin titles and descriptions

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.

Files in the repo

Repository payload8 top-level entries
  • .claude-plugin
  • skills
  • tools
  • .gitignore
  • AGENTS.md
  • LICENSE
  • README.md
  • validate-skills.sh

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k
ayghri/
i-have-adhd

A skill to stop your coding agent from burying the answer. ADHD-friendly output.

38k
mvanhorn/
last30days-skill

AI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary

62k
Nanako0129/
sepia

De-AI writing skill for any Agent Skills-compatible agent (77+ via the Skills CLI), with native plugins for Claude Code, Codex, Grok Build, and Antigravity. Narrative-architecture repair for fiction, venue-matched rules for professional prose. Based on StoryScope (arXiv:2604.03136).

2.5k
Imbad0202/
academic-research-skills

Academic Research Skills for Claude Code: research → write → review → revise → finalize

48k