{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/banner.svg\" alt=\"Social Media Skills by Charlie Hills\" width=\"100%\"/>\n</p>\n\n# Social Media Skills for AI Agents\n\nThe complete set of Claude skills behind Charlie Hills' content system. 415k+ followers across LinkedIn, Instagram, Substack, X and YouTube. 100m+ views per year. All running through one system that starts with the newsletter and flows out to every other channel.\n\nBuilt by [Charlie Hills](https://charliehills.substack.com). Subscribe to the [MarTech AI newsletter](https://charliehills.substack.com) for weekly breakdowns of how this system works in practice.\n\n**Contributions welcome.** Found a way to improve a skill? [Open a PR](https://github.com/charlie947/social-media-skills/pulls). Run into a problem? [Open an issue](https://github.com/charlie947/social-media-skills/issues).\n\n## What are Skills?\n\nSkills are markdown files that give AI agents specialised knowledge and workflows for specific tasks. When you install these in your project, Claude recognises when you're working on a social media task and applies the right patterns, voice rules, and platform constraints.\n\n## How Skills Work Together\n\nEvery skill reads shared context. The `voice-builder` skill is the foundation. Every other skill checks it first (via `about-me.md` and `voice.md`) before drafting a line.\n\n```\n                    ┌──────────────────────────────────────┐\n                    │           voice-builder              │\n                    │   about-me.md + voice.md             │\n                    │   (read by every skill below)        │\n                    └──────────────────┬───────────────────┘\n                                       │\n                    ┌──────────────────▼───────────────────┐\n                    │         newsletter-voice             │\n                    │   newsletter-voice.md                │\n                    │   (the source every piece comes from)│\n                    └──────────────────┬───────────────────┘\n                                       │\n     ┌────────────┬────────────┬───────┴───────┬────────────┬────────────┐\n     ▼            ▼            ▼               ▼            ▼            ▼\n┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐ ┌──────────┐ ┌──────────┐\n│ Profile  │ │LinkedIn  │ │ Video    │ │ Analytics &  │ │Community │ │Standalone│\n│          │ │ posts    │ │          │ │ Scoring      │ │          │ │          │\n├──────────┤ ├──────────┤ ├──────────┤ ├──────────────┤ ├──────────┤ ├──────────┤\n│profile-  │ │post-     │ │reels-    │ │post-scorer   │ │pinned-   │ │hook-gen  │\n│ optimizer│ │ writer   │ │ scripting│ │              │ │ comment  │ │content-  │\n│          │ │graphic-  │ │youtube-  │ │analytics-    │ │          │ │ matrix   │\n│          │ │ designer │ │ thumbnail│ │ dashboard    │ │          │ │niche-    │\n│          │ │          │ │          │ │              │ │          │ │ research │\n│          │ │post-form │ │          │ │              │ │          │ │gemini-*  │\n│          │ │          │ │          │ │              │ │          │ │quote-post│\n└──────────┘ └──────────┘ └──────────┘ └──────────────┘ └──────────┘ └──────────┘\n```\n\nSee each skill's `SKILL.md` for trigger phrases, inputs, and dependencies.\n\n## Available Skills\n\n<!-- SKILLS:START -->\n| Skill | Description |\n|---|---|\n| [voice-builder](skills/voice-builder/) | Build `about-me.md` and `voice.md` from an interview plus 3 to 5 writing samples. The foundation every other skill reads. |\n| [newsletter-voice](skills/newsletter-voice/) | Add newsletter-specific writing instructions on top of voice-builder. Produces `newsletter-voice.md`. |\n| [profile-optimizer](skills/profile-optimizer/) | Rebuild a LinkedIn profile for conversions. Headline, about, experience, featured section, plus 4 image generation prompts. |\n| [post-writer](skills/post-writer/) | Draft LinkedIn posts in your voice using the voice files. |\n| [graphic-designer](skills/graphic-designer/) | Pick between HTML/CSS graphic and AI-generated infographic based on the post content. |\n| [post-scorer](skills/post-scorer/) | Pull your post history via Apify and score any draft against what actually performs for you. |\n| [reels-scripting](skills/reels-scripting/) | Reverse-engineer an outlier Reel via Apify + Gemini 2.5 Flash. Write a new script in your voice from your newsletter. |\n| [youtube-thumbnail](skills/youtube-thumbnail/) | Turn a video title into a branded YouTube thumbnail prompt for Gemini. |\n| [pinned-comment](skills/pinned-comment/) | Meme-style pinned comments with a matching image generation prompt. |\n| [hook-generator](skills/hook-generator/) | 6 clickbait-style two-line hook variations per topic. |\n| [post-formatter](skills/post-formatter/) | Topic to ready-to-publish post using PAS, AIDA, BAB, STAR, or SLAY. |\n| [content-matrix](skills/content-matrix/) | Pair your pillars with 8 formats for 32+ post ideas in one table. Justin Welsh style. |\n| [niche-research](skills/niche-research/) | Drive Claude for Chrome to scroll Reddit, X, and Google with verified dates. Surfaces the 20 most relevant stories in your niche from the last 7 days. |\n| [gemini-infographic](skills/gemini-infographic/) | The whiteboard style that pulled 480k impressions from 3 posts. |\n| [gemini-carousel](skills/gemini-carousel/) | Slide-by-slide carousel generator with an approval gate. |\n| [quote-post](skills/quote-post/) | Claude writes the quote, Gemini recreates the image with the quote baked in. |\n| [analytics-dashboard](skills/analytics-dashboard/) | LinkedIn Analytics export to interactive React dashboard plus 5 data-backed recommendations. |\n<!-- SKILLS:END -->\n\n## Installation\n\n### Option 1: Claude Code plugin marketplace\n\n```bash\n# Add the marketplace\n/plugin marketplace add charlie947/social-media-skills\n\n# Install the plugin\n/plugin install social-media-skills\n```\n\n### Option 2: Clone and copy\n\n```bash\ngit clone https://github.com/charlie947/social-media-skills.git\ncp -r social-media-skills/skills/* ~/.claude/skills/\n```\n\n### Option 3: Individual skill upload (Claude Desktop)\n\nDownload any skill folder, zip it, and upload via Customise skills in Claude.\n\n```bash\ncd social-media-skills/skills\nzip -r voice-builder.skill voice-builder\n# Upload voice-builder.skill through Customise skills in the Claude app\n```\n\n### Option 4: Git submodule\n\n```bash\ngit submodule add https://github.com/charlie947/social-media-skills.git .agents/social-media-skills\n```\n\nThen reference skills from `.agents/social-media-skills/skills/`.\n\n### Option 5: Fork and customise\n\nFork the repo, swap the voice rules for your own, and clone your fork into your projects.\n\n## Usage\n\nRun `voice-builder` first. Every other skill needs `about-me.md` and `voice.md` to work properly.\n\nOnce installed, ask Claude to help with content tasks and it will pick the right skill:\n\n```\n\"Build my voice\" → voice-builder\n\"Write me a post about AI agents\" → post-writer\n\"Score this draft against my history\" → post-scorer\n\"Make me a carousel from this\" → gemini-carousel\n\"What should I post this week\" → niche-research or content-matrix\n\"Turn this outlier Reel into a script\" → reels-scripting\n\"I need a thumbnail for 'How I fired my team'\" → youtube-thumbnail\n\"Write me a pinned comment\" → pinned-comment\n```\n\n## Skill Categories\n\n### Voice foundation\n- `voice-builder` — interview + sample analysis, writes about-me.md and voice.md\n- `newsletter-voice` — newsletter-specific writing rules on top of voice-builder\n\n### LinkedIn\n- `profile-optimizer` — full profile rebuild\n- `post-writer` — drafts in your voice\n- `graphic-designer` — HTML/CSS graphic or AI infographic, auto-selected\n- `post-formatter` — topic to post via named framework (PAS, AIDA, BAB, STAR, SLAY)\n- `hook-generator` — 6 hook variations per topic\n- `post-scorer` — scores drafts against your post history\n- `content-matrix` — pillars x formats ideation\n- `niche-research` — 7-day niche research via Claude for Chrome\n- `gemini-infographic` — whiteboard style for Gemini\n- `gemini-carousel` — slide-by-slide carousel\n- `quote-post` — two-step quote workflow\n\n### Instagram Reels\n- `reels-scripting` — Apify + Gemini 2.5 Flash reference analysis, newsletter-aligned script\n\n### YouTube\n- `youtube-thumbnail` — title to Gemini thumbnail prompt\n\n### Community\n- `pinned-comment` — meme-style pin + image prompt\n\n### Analytics\n- `analytics-dashboard` — LinkedIn export to dashboard + 5 recommendations\n\n## Prerequisites\n\nA few skills need external services. Set these environment variables before use:\n\n| Variable | Needed for |\n|---|---|\n| `APIFY_API_TOKEN` | post-scorer, reels-scripting |\n| `GOOGLE_AI_API_KEY` | reels-scripting (Gemini 2.5 Flash video analysis) |\n\nSet them with:\n\n```bash\nexport APIFY_API_TOKEN=your_token\nexport GOOGLE_AI_API_KEY=your_key\n```\n\nThe image generation skills (`gemini-infographic`, `gemini-carousel`, `quote-post`, `youtube-thumbnail`, `profile-optimizer`) output ready-to-paste prompts. You run them in a separate Gemini chat with Create Image enabled. No API key needed.\n\n## Contributing\n\nPRs and issues welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on adding or improving skills.\n\nRun `./validate-skills.sh` before submitting to check your skill against the spec.\n\n## License\n\n[MIT](LICENSE). Use these however you like. If they help you, a link back to the [newsletter](https://charliehills.substack.com) is appreciated.\n\n— Charlie\n",
  "bytes": 9421,
  "sha": "6145e1ca9ad0bf448d857b64009303a720fc9bc3e0fbf0ec3f6171ccf4b79bca",
  "repo_slug": "charlie947/social-media-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_charlie947_social_media_skills_youtube_t_140fd56f/readme"
}