Skip to content
Back to search

social-ai-team

Claude Code skills for social media — a complete AI social team for SMBs. Brand setup, content calendar, captions, creative, and performance review.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/stevenflanagan1--social-ai-team/badge.svg)](/listings/stevenflanagan1--social-ai-team)

HTML

<a href="/listings/stevenflanagan1--social-ai-team"><img src="/api/listings/stevenflanagan1--social-ai-team/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> **New to this?** See [SETUP.md](SETUP.md) for a full beginner walkthrough — Claude Code, MCPs, and your first client folder.

1. Get the files

**Option A — Clone with git:**

git clone https://github.com/stevenflanagan1/social-ai-team.git
cd social-ai-team

**Option B — Download ZIP:** click the green **Code** button at the top of this repo, choose **Download ZIP**, unzip it, then open the `social-ai-team` folder in a terminal.

2. Run the installer

**Mac / Linux:**

bash install.sh

**Windows:** double-click `install.bat` (or run it from the command line).

This copies all 10 skills into `~/.claude/skills/` where Claude Code can find them.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 253 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Social AI Team
  2. A set of Claude Code skills that work together as a complete social media team for small and medium businesses. Each skill is a specialist. Together they run the full workflow — from brand setup to platform-native content creation to scheduling and monthly performance review.
  3. Built to run inside [Claude Code](https://claude.ai/code).
  4. > **Just getting started?** Read [SETUP.md](SETUP.md) — a full beginner walkthrough covering Claude Code, install, MCP setup, and your first client.
  5. ---
  6. ## How the Skills Work Together
  7. ```
  8. /social-media-manager ← start here (orchestrates everything)
  9. │
  10. │ LAYER 1 — FOUNDATION
  11. ├── /brand-onboarding ──────────→ context/brand-style.md
  12. │ Run once per client. │
  13. │ Captures brand identity, │ (read by all skills below)
  14. │ voice, and goals. │
  15. │ ▼
  16. ├── /content-calendar ──────────→ context/content-calendar.md
  17. │ Run monthly. │
  18. │ Builds a structured month │ (read by all content skills)
  19. │ of post ideas. │
  20. │ │
  21. │ LAYER 2 — CONTENT CREATION │
  22. ├── /caption-writer ────────────→ outputs/captions/
  23. │ Instagram, Facebook,
  24. │ and multi-platform captions.
  25. │
  26. ├── /social-creative-designer ──→ outputs/creatives/
  27. │ Branded visuals via Nano Banana
  28. │ (Generate / Composite / Brand / Stop-Motion).
  29. │
  30. ├── /linkedin-writer ───────────→ outputs/linkedin/
  31. │ LinkedIn-native posts.
  32. │ First-person, insight-led,
  33. │ built for LinkedIn's format.
  34. │
  35. ├── /threads-writer ────────────→ outputs/threads/
  36. │ Threads posts.
  37. │ Short, direct, opinion-led,
  38. │ 500 char limit enforced.
  39. │
  40. ├── /x-writer ─────────────────→ outputs/x/
  41. │ X/Twitter posts and threads.
  42. │ Punchy, standalone hooks,
  43. │ 280 char limit enforced.
  44. │
  45. │ LAYER 3 — DISTRIBUTION & REVIEW
  46. ├── /publisher ─────────────────→ Blotato (scheduled posts)
  47. │ Optional. Schedules content
  48. │ via Blotato and generates
  49. │ infographic visuals.
  50. │
  51. └── /social-performance-review ─→ outputs/reviews/
  52. Run end of month. │
  53. Analyses what worked, │
  54. what didn't, and why. ▼
  55. context/best-performers.md
  56. (feeds back into next month)
  57. ```
  58. ### Skills cross-reference each other:
  59. - `/brand-onboarding` → writes `brand-style.md` → read by all content skills
  60. - `/content-calendar` → writes `content-calendar.md` → read by all Layer 2 content skills
  61. - `/caption-writer` → writes Visual Direction field → read by `/social-creative-designer`
  62. - `/linkedin-writer`, `/threads-writer`, `/x-writer` → write BLOTATO FLAG field → read by `/publisher`
  63. - `/social-performance-review` → updates `best-performers.md` → read by all content skills next month
  64. ---
  65. ## What Each Skill Does
  66. ### `/social-media-manager` — Orchestrator
  67. The coordinator. Reads the current state of a client's workflow and routes to the right starting point — new client setup, monthly production, platform-specific content, end-of-month review, or a specific task. Pause-and-approve gates at every handoff prevent downstream mistakes.
  68. ### `/brand-onboarding` — Brand Strategist
  69. Run once per client before anything else. Uses Playwright to capture evidence from the client's website and Instagram, generates a pre-filled client onboarding doc, then synthesises everything into `context/brand-style.md` — the single source of truth for all creative and content work.
  70. ### `/content-calendar` — Social Media Strategist
  71. Builds a structured month of post ideas. Defines content pillar ratios and format mix before building. Each post entry includes topic, angle, format, objective, and visual direction. Saves to `context/content-calendar.md` for all content skills to read.
  72. ### `/caption-writer` — Senior Copywriter
  73. Writes ready-to-post captions from the calendar. Six storytelling frameworks, platform-specific formatting for Instagram / LinkedIn / Facebook / TikTok / X. Every caption includes a Visual Direction field as a handoff note for `/social-creative-designer`.
  74. ### `/social-creative-designer` — Creative Designer
  75. Generates on-brand social visuals using the Nano Banana image generation MCP. Four modes:
  76. - **Generate** — AI image from a concept (lifestyle / atmospheric content)
  77. - **Composite** — anchors the client's real product photo in an AI-generated scene
  78. - **Brand** — applies text overlay treatment to a real client photo
  79. - **Stop-Motion** — 6-frame action sequence exported as a looping MP4 Reel
  80. ### `/linkedin-writer` — LinkedIn Content Specialist
  81. Writes LinkedIn-native posts — not adapted captions. First-person, professional-but-human voice, structured for LinkedIn's format: hook line → short paragraphs → insight → CTA → 3-5 hashtags. Flags posts that would benefit from a Blotato infographic (stats, frameworks, numbered lists).
  82. ### `/threads-writer` — Threads Content Specialist
  83. Writes Threads posts: short, direct, opinion-led, made for conversation. Strictly enforces the 500 character limit with a count on every post. Supports standalone posts and connected threads. Takes outperform tips on Threads — this skill writes for how the platform actually works.
  84. ### `/x-writer` — X/Twitter Content Specialist
  85. Writes X-native posts and threads. Strictly enforces the 280 character limit with a count on every post. Every post works without context — no warm-ups, no preamble. X thread format (1/, 2/...). Optional X trend research via X API.
  86. ### `/publisher` — Social Media Publisher
  87. Takes approved content from any content skill and schedules it via Blotato MCP. Checks the Blotato connection first — shows a clear setup message if not connected. Generates infographic visuals (stat cards, framework diagrams, 3-step process graphics, quote graphics) for posts flagged by platform specialists. Full schedule confirmation before submitting anything. Blotato is optional — all other skills work without it.
  88. ### `/social-performance-review` — Social Media Analyst
  89. Monthly performance review. Accepts CSV exports, screenshots, or manual data input — adapts to whatever the client can provide. Identifies top and bottom performers, content pillar and format patterns, and produces ranked recommendations for next month. Updates `best-performers.md` to feed back into content quality.
  90. ---
  91. ## Folder Structure (Per Client)
  92. When you run these skills for a client, they create and read from this structure automatically:
  93. ```
  94. your-client-folder/
  95. ├── context/
  96. │ ├── brand-style.md ← created by /brand-onboarding
  97. │ ├── content-calendar.md ← created by /content-calendar
  98. │ ├── best-performers.md ← created/updated by /social-performance-review
  99. │ ├── upcoming-events.md ← you create this (optional)
  100. │ └── workflow-status.md ← updated by /social-media-manager
  101. ├── assets/
  102. │ ├── products/ ← client product photos go here
  103. │ └── lifestyle/ ← lifestyle shots go here
  104. └── outputs/
  105. ├── captions/ ← /caption-writer (Instagram, Facebook)
  106. ├── linkedin/ ← /linkedin-writer
  107. ├── threads/ ← /threads-writer
  108. ├── x/ ← /x-writer
  109. ├── creatives/ ← /social-creative-designer (Nano Banana visuals)
  110. └── reviews/ ← /social-performance-review
  111. ```
  112. ---
  113. ## Installation
  114. > **New to this?** See [SETUP.md](SETUP.md) for a full beginner walkthrough — Claude Code, MCPs, and your first client folder.
  115. ### 1. Get the files
  116. **Option A — Clone with git:**
  117. ```bash
  118. git clone https://github.com/stevenflanagan1/social-ai-team.git
  119. cd social-ai-team
  120. ```
  121. **Option B — Download ZIP:** click the green **Code** button at the top of this repo, choose **Download ZIP**, unzip it, then open the `social-ai-team` folder in a terminal.
  122. ### 2. Run the installer
  123. **Mac / Linux:**
  124. ```bash
  125. bash install.sh
  126. ```
  127. **Windows:** double-click `install.bat` (or run it from the command line).
  128. This copies all 10 skills into `~/.claude/skills/` where Claude Code can find them.
  129. ---
  130. ## MCP Requirements
  131. Some skills use MCP tools for enhanced functionality. Skills work in **baseline mode** without them, but these unlock additional capabilities:
  132. | MCP | Used by | What it enables |
  133. |---|---|---|
  134. | **Playwright** | `/brand-onboarding` | Evidence capture from website + Instagram |
  135. | **Nano Banana** | `/social-creative-designer` | AI image generation (required for branded visuals) |
  136. | **Blotato** | `/publisher` | Post scheduling + infographic generation (optional — only needed for publishing) |
  137. | **Firecrawl** | `/content-calendar`, `/caption-writer`, `/social-performance-review`, `/linkedin-writer`, `/x-writer` | Competitor content research (optional) |
  138. | **SerpApi** | `/content-calendar`, `/caption-writer` | Trend research (optional) |
  139. | **X API** | `/x-writer` | X/Twitter trend research (optional) |
  140. Playwright and Nano Banana are the two you need for the core workflow. Blotato is optional — all content creation skills work without it. You only need Blotato if you want to schedule posts directly from Claude Code. Firecrawl, SerpApi, and Tasty Content are optional enhancements.
  141. ### Stop-Motion Reels (optional)
  142. The `/social-creative-designer` Stop-Motion mode exports frames as an MP4 via Python. Requires:
  143. ```bash
  144. pip install imageio[ffmpeg]
  145. ```
  146. ---
  147. ## How to Use
  148. ### New client
  149. ```
  150. /social-media-manager
  151. ```
  152. The orchestrator will detect that no brand file exists and walk you through `/brand-onboarding` first.
  153. ### Running a specific skill directly
  154. ```
  155. /brand-onboarding
  156. /content-calendar
  157. /caption-writer
  158. /social-creative-designer
  159. /linkedin-writer
  160. /threads-writer
  161. /x-writer
  162. /publisher
  163. /social-performance-review
  164. ```
  165. ### Publishing content (Blotato)
  166. After writing LinkedIn, Threads, or X content with the platform specialists:
  167. ```
  168. /publisher
  169. ```
  170. The publisher checks your Blotato connection, reviews flagged infographic opportunities, confirms the schedule, and submits. Requires Blotato to be configured first — see the MCP Requirements section above.
  171. ### Monthly workflow (existing client)
  172. ```
  173. /social-media-manager
  174. ```
  175. The orchestrator reads `context/workflow-status.md` and picks up exactly where you left off.
  176. ---
  177. ## Recommended Setup per Client
  178. 1. Create a dedicated folder for the client
  179. 2. `cd` into that folder before running any skill — context files are scoped to the working directory
  180. 3. Run `/social-media-manager` to start
  181. ```bash
  182. mkdir my-client && cd my-client
  183. # open Claude Code in this folder
  184. # then run /social-media-manager
  185. ```
  186. ---
  187. ## Reference Files
  188. Three reference documents are bundled with the relevant skills:
  189. | File | Used by | Contents |
  190. |---|---|---|
  191. | `content-calendar/references/content-mix-guide.md` | `/content-calendar` | Recommended pillar ratios by business type |
  192. | `caption-writer/references/hook-library.md` | `/caption-writer` | 40+ hook formulas by type |
  193. | `social-performance-review/references/benchmarks.md` | `/social-performance-review` | Engagement benchmarks by platform and account size |
  194. ---
  195. ## License
  196. Created by the AI Impact use it, adapt it, build on it. Want a custom build? https://theaiimpact.co/

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.