# Social Media Skills: 14 AI Agent Skills for Claude Code > Social Media Skills is a collection of 14 composable Claude Code skills covering content strategy, post creation, and performance analysis for eight social platforms. It installs via npx in under a minute and works without a subscription for text generation, though live publishing and analytics require the BlackTwist MCP server. **blacktwist/social-media-skills** — AI agent skills for social media content strategy, creation, and analysis across text-first platforms - Repository: https://github.com/blacktwist/social-media-skills - Website: https://blacktwist.app/ - Stars: 541 · Forks: 89 - Language: Shell - License: MIT - Published: 2026-09-10 · Updated: 2026-09-10 · Language: en - Canonical page: https://hysenlabs.com/projects/blacktwist-social-media-skills ## What Social Media Skills does and who it is built for Social Media Skills is a repository of 14 Claude Code skills organized around a social media workflow. The skills cover three broad jobs: content strategy and planning, content creation across multiple formats, and post-performance analysis. The project is aimed at engineers or content teams already using Claude Code who want structured AI assistance for social media tasks without running a separate writing or scheduling application. The repository ships skills for both text-first and visual-first platforms, but the level of support differs. Text-first platforms (LinkedIn, Twitter/X, Threads, and Bluesky) receive the full set of creation and strategy skills. Visual-first platforms (Facebook, Instagram, TikTok, and Pinterest) receive caption support only, through a single skill called caption-writer-sms. This is not a standalone application. Each skill is a prompt definition that tells Claude Code how to behave for a specific task. The repository does nothing useful outside a Claude Code or compatible multi-agent environment. ## How the 14 skills are organized The skills fall into four groups. One foundation skill, social-media-context-sms, captures platform context, audience details, content pillars, and tone preferences. The README states that all other skills use this foundation, so running it first establishes consistent voice across the session. Three strategy skills handle planning. Content-strategy-sms defines content pillars and audience positioning. Content-calendar-sms plans publishing cadence and themes across platforms. Platform-strategy-sms tailors the approach per platform based on format strengths. Six creation skills produce content. Post-writer-sms writes single standalone posts. Thread-writer-sms writes multi-post threads with a narrative arc and a strong opening hook. Carousel-writer-sms generates slide-by-slide scripts for LinkedIn carousels. Caption-writer-sms writes captions for visual platforms. Content-repurposer-sms transforms existing content into new formats across platforms. Hook-writer-sms produces opening lines for posts. Four analysis skills work with performance data. Performance-analyzer-sms interprets post and account metrics. Audience-growth-tracker-sms tracks follower trends. Content-pattern-analyzer-sms identifies which content types perform best. Optimization-advisor-sms recommends improvements from those patterns. The analysis skills do not pull live data from any platform. You must supply performance metrics to the skill directly; it interprets what you provide. ## Installing Social Media Skills into a Claude Code project The recommended installation method uses npx: ```bash npx skills add blacktwist/social-media-skills ``` This copies the skills into .agents/skills/ and symlinks them into .claude/skills/ for Claude Code compatibility. To install specific skills rather than the full set: ```bash npx skills add blacktwist/social-media-skills --skill post-writer-sms hook-writer-sms ``` To see all available skills before installing: ```bash npx skills add blacktwist/social-media-skills --list ``` For teams using multiple AI agents alongside Claude Code, a SkillKit alternative is documented: ```bash npx skillkit install blacktwist/social-media-skills ``` A git submodule option is also available for projects that want to track updates through version control: ```bash git submodule add https://github.com/blacktwist/social-media-skills.git .agents/social-media-skills ``` After installation, the foundation skill social-media-context-sms should be invoked first in any session to populate the shared context that the other skills read. The repository also supports manual installation by cloning and copying the skills folder, and a Claude Code Cowork path that uploads individual skill zip files through the UI. ## BlackTwist MCP integration and what advisory mode means The README identifies BlackTwist as the primary tool integration for this skill set, pointing to a hosted MCP server at blacktwist.app/mcp. When that server is connected to the Claude environment, skills can publish and schedule posts, fetch analytics and engagement data, manage draft content, and track follower growth. When the BlackTwist server is not connected, the README states that skills run in advisory mode. In this mode, skills generate content text and manual posting instructions rather than taking direct action. The analysis skills return advice text rather than live numbers. This is a meaningful limitation for teams expecting automated workflows: without the MCP connection, the result of every creation skill is a text block you must copy and paste yourself. The README points to tools/REGISTRY.md for the complete tool reference, but that file is not included in the repository listing that is visible here. Whether skills can integrate with other MCP servers or other publishing APIs beyond BlackTwist is not documented in the README. ## Platform coverage: the gap between text-first and visual-first The repository documents a two-tier platform model. Text-first platforms receive the full skill set, including strategy, creation, and analysis skills. LinkedIn support covers long-form posts, carousels, and newsletters. Twitter/X covers posts, threads, and spaces. Threads (Meta) covers posts and threads. Bluesky covers posts, threads, and starter packs. Visual-first platforms receive support through a single skill only. Caption-writer-sms covers Facebook feed posts and video captions, Instagram feed, Reels, carousels, and stories, TikTok short-form video captions, and Pinterest pin titles and descriptions. This split matters for teams that use Instagram or TikTok as primary channels. The creation skills for threads, carousels, and hooks are built around text formats. There are no skills for generating image dimensions, video scripts with timing cues, or platform-specific metadata beyond captions. A team whose core channel is Instagram will get considerably less structured assistance than a team whose core channel is LinkedIn. ## Limitations and when to look at alternatives Social Media Skills requires Claude Code. Teams not already using Claude Code will need to install and configure the environment before any skill is functional. This is not a browser extension or a web application: the skill files are prompt definitions, and they only activate inside a compatible agent runtime. The analysis skills are interpretation tools, not data collection tools. There is no mechanism documented in the README for the skills to pull post metrics automatically from a platform API. A dedicated social analytics product like Sprout Social handles platform API authentication, data ingestion, and reporting directly. Social Media Skills handles the interpretation step only, and only if you provide the data. Buffer is a commonly used alternative for teams that want scheduling, a publishing queue, and multi-platform management in one product. Buffer operates as a hosted service with its own interface and platform OAuth connections. Social Media Skills operates as a set of prompts inside Claude Code, with publishing gated on the BlackTwist MCP server. The two products occupy different points in a workflow. Buffer is better suited to teams that want a dedicated publishing tool. Social Media Skills is better suited to teams who want AI-assisted drafting inside an environment they already use for engineering work. ## Maintenance status and licensing The repository released v1.1.0 on 2026-04-06, v1.2.0 on 2026-04-20, and v1.3.0 on 2026-05-01, the last recorded push. The three releases in under two months suggest active early development. There have been no releases since May 2026. The license is MIT. MIT permits use, modification, and redistribution without commercial restriction, requiring only that the license notice is preserved in derived works. This means you can fork the repository and customize skills for your organization without licensing concerns, which the README explicitly supports as installation Option 4. The repository is generated from the BlackTwist source and the README notes it takes no pull requests. Contributions should go through the upstream product rather than directly to this repository. ## Conclusion Engineers and content teams who already work in Claude Code and want structured AI assistance for social media without switching to a separate tool will find the skill organization genuinely practical: the foundation skill carries context across the full set so you set your brand voice once. Teams that do not use Claude Code should budget time for that setup before expecting any skill to work. Anyone who needs automated publishing or live analytics must verify the BlackTwist MCP server covers their required platforms before committing to this stack, since skills fall back to plain text instructions when the server is absent. The last release was v1.3.0 on 2026-05-01. ## FAQ ### Does Social Media Skills work without a BlackTwist account? Yes. Without the BlackTwist MCP server connected, all skills operate in advisory mode: they generate content and posting instructions that you carry out manually. Publishing, scheduling, and automated analytics ingestion require the BlackTwist connection. ### Which AI agent environments are compatible with Social Media Skills? The README documents installation for Claude Code as the primary target, with .claude/skills/ symlinks created automatically. The SkillKit installation option extends compatibility to Cursor and Copilot. The README does not specify a minimum Claude Code version. ### Can Social Media Skills be customized for a specific brand voice? The foundation skill social-media-context-sms is designed to capture audience details, content pillars, and tone preferences that all other skills inherit. The README also lists forking the repository and customizing skills as an explicit installation option, so a brand-specific fork is a documented path. ## Sources - [blacktwist/social-media-skills on GitHub](https://github.com/blacktwist/social-media-skills) - [License: MIT](https://github.com/blacktwist/social-media-skills/blob/main/LICENSE) - [Project website](https://blacktwist.app/) - [README](https://github.com/blacktwist/social-media-skills/blob/main/README.md) - [Releases](https://github.com/blacktwist/social-media-skills/releases) --- Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/blacktwist-social-media-skills