Social Media Skills for AI Agents

Social Media Skills is an open-source collection of Claude AI agent skills built by Charlie Hills to power a multi-platform content system. The repository is licensed under MIT and available on GitHub, where it has accumulated over 2,400 stars and 569 forks as of mid-2026. Each skill is a markdown file that gives Claude specialized knowledge and workflows for specific social media tasks.

What It Is

Social Media Skills is a modular skill library for Claude AI agents, organized around a voice-first architecture. The voice-builder skill acts as the foundation — it generates about-me.md and voice.md from an interview and writing samples — and every other skill reads those files before producing any content. This ensures all output stays consistent with the creator's established voice across platforms. The system is designed to flow content from a newsletter source outward to LinkedIn, Instagram, YouTube, and community channels.

Skill Architecture and Categories

The library is organized into six functional groups, each with dedicated skills:

• Voice foundation: voice-builder (interview + sample analysis) and newsletter-voice (newsletter-specific writing rules)
• LinkedIn: post-writer, profile-optimizer, graphic-designer, post-formatter, hook-generator, post-scorer, content-matrix, niche-research, gemini-infographic, gemini-carousel, quote-post
• Instagram Reels: reels-scripting (uses Apify + Gemini 2.5 Flash for reference analysis)
• YouTube: youtube-thumbnail (title to Gemini thumbnail prompt)
• Community: pinned-comment (meme-style pin with image prompt)
• Analytics: analytics-dashboard (LinkedIn export to interactive React dashboard with recommendations)

How Skills Are Triggered

Once installed, Claude recognizes natural-language task descriptions and routes them to the appropriate skill automatically. For example, asking "Write me a post about AI agents" triggers post-writer, while "Score this draft against my history" triggers post-scorer. The post-formatter skill supports named copywriting frameworks including PAS, AIDA, BAB, STAR, and SLAY. The niche-research skill drives Claude for Chrome to scroll Reddit, X, and Google and surfaces the 20 most relevant stories from the past 7 days.

Installation Options

The repository supports five installation paths:

• Claude Code plugin marketplace: one-line install via /plugin install social-media-skills
• Clone and copy: copy skill folders directly into ~/.claude/skills/
• Individual skill upload: zip a skill folder and upload via Claude Desktop's "Customise skills" UI
• Git submodule: reference skills from .agents/social-media-skills/skills/
• Fork and customize: swap voice rules for your own and clone your fork

Two external services are required for some skills: APIFY_API_TOKEN for post-scorer and reels-scripting, and GOOGLE_AI_API_KEY for Gemini 2.5 Flash video analysis in reels-scripting. Image generation skills output ready-to-paste prompts for Gemini's Create Image feature and require no API key.

Current Status

The repository was created in April 2026 and last pushed to in August 2026, indicating active development. It is maintained under the MIT License and accepts community contributions via pull requests. A validate-skills.sh script is included to check skill compliance before submission. The project is described by its author as the complete skill set behind a content system the author claims reaches 415k+ followers and 100m+ views per year across LinkedIn, Instagram, Substack, X, and YouTube.