social-media-skills

mcp
Security Audit
Pass
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 55 GitHub stars
Code Pass
  • Code scan — Scanned 2 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool provides a suite of AI agent skills designed to help users plan, write, and analyze social media content across text-first platforms.

Security Assessment
The overall risk is Low. The repository contains only 2 files, and a light code scan found no dangerous patterns, hardcoded secrets, or requests for risky permissions. Because it is built in Shell, there is an inherent ability to execute system commands; however, the current codebase appears entirely clean. The tool does not seem to make external network requests or directly access sensitive local data.

Quality Assessment
The project is actively maintained, with its most recent push occurring just today. It is fully licensed under the standard MIT license, making it highly accessible for integration into other projects. Additionally, it has earned 55 GitHub stars, indicating a baseline level of community trust and interest from other developers.

Verdict
Safe to use.
SUMMARY

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

README.md

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.

Reviews (0)

No results found