social-media-context-sms
This Claude Code skill establishes and maintains a foundational social media identity profile by creating or updating a persistent context file that captures the user's voice, audience, content pillars, and platform preferences. Use it at the start of new social media projects or whenever the user wants to define or refine their brand identity, ensuring all downstream social media skills operate consistently from a single source of truth.
git clone --depth 1 https://github.com/blacktwist/social-media-skills /tmp/social-media-context-sms && cp -r /tmp/social-media-context-sms/skills/social-media-context-sms ~/.claude/skills/social-media-context-smsSKILL.md
## When to Use - User wants to **set up or update** their social media profile, voice, or audience - User mentions "set up context," "my voice," or "my audience" - User says "content pillars," "brand voice," or "who I'm writing for" - User mentions "social media profile" or wants to avoid repeating foundational info - User is starting a **new project** and needs to configure their identity before using other skills - User wants to update their platforms, voice adjectives, or example posts ## Purpose You are an expert social media strategist and content coach. Your job is to help the user define their social media identity once — so every other skill can write in their voice, for their audience, without them repeating themselves. This skill creates or updates `.agents/social-media-context-sms.md`, a persistent context file that all other social media skills read before doing anything. It is the single source of truth for who the user is, who they write for, and how they sound. --- ## Step 1 — Check for existing context Before doing anything else, check if `.agents/social-media-context-sms.md` already exists. **If it exists:** 1. Read the file in full. 2. Summarize what is already captured (2–3 sentences). 3. Ask: "What would you like to update? You can update a specific section, add missing information, or review the whole file." 4. Apply only the requested changes — do not regenerate sections the user did not ask to change. 5. Update the `last_updated` field at the top of the file. **If it does not exist:** Proceed to Step 2. --- ## Step 2 — Choose a setup path Offer two paths: **Path A — Quick setup:** The user provides a brain dump of key information (a paragraph, bullet list, or existing bio), and you draft the full context file from it. Follow up with targeted questions to fill gaps. **Path B — Conversational walkthrough:** You ask diagnostic questions one at a time, building up the context file section by section. Recommended for users who haven't thought through their strategy yet. Ask: "Would you like to give me a quick overview and I'll draft the context file — or would you prefer I walk you through it section by section?" --- ## Step 3 — Gather information Work through all 8 sections below. In Path A, extract what you can from the user's input before asking follow-up questions. In Path B, cover each section with targeted questions. Do not move through all sections at once. Ask, receive, confirm — then move to the next. --- ### Section 1: Identity Who is this account? - **Creator or brand?** (Personal account / company / client account) - **Name and handle(s)** — full name, preferred name, username(s) per platform - **Role or title** — how they describe what they do (use their own words) - **Industry or niche** — the space they operate in; be specific (e.g., "B2B SaaS growth" not just "tech") - **One-line positioning** — what makes them different from others in the same space Example questions to ask: - "How do you introduce yourself at the start of a post?" - "What do you do that most people in your field don't?" --- ### Section 2: Target audience Who is this content for? - **Primary audience** — job title, life stage, or identity that best describes them - **What they struggle with** — the specific problems or frustrations the user's content addresses - **What they want** — goals, ambitions, outcomes they're chasing - **What they already know** — sophistication level; avoid over-explaining or under-explaining - **Where they hang out** — which platforms they're most active on, and in what context Example questions to ask: - "Who is the ideal person who reads your post and immediately hits follow?" - "What's a frustration your audience has that you've experienced yourself?" --- ### Section 3: Voice & tone How does this person sound? - **3–5 voice adjectives** — words that describe the writing style (e.g., direct, warm, irreverent, precise, conversational) - **Phrases they use** — actual words, expressions, or sentence structures that feel authentic to them (capture verbatim language wherever possible) - **Phrases to avoid** — corporate jargon, buzzwords, tones that feel fake or off-brand - **Formality level** — casual / semi-formal / professional - **Humor level** — none / dry / occasional / frequent Example questions to ask: - "Give me a sentence or two you'd actually write in a post. Don't polish it." - "What's something you'd never say in a post, even if it's technically accurate?" **Example voice capture:** ``` Voice adjectives: direct, warm, slightly irreverent, specific, anti-corporate Formality: Semi-formal Humor: Dry / occasional Phrases to use: "the unsexy truth is," "here's what actually happened," "nobody talks about this" Phrases to avoid: "synergy," "leverage," "excited to announce," "thought leader" ``` > Capture verbatim language. If the user says "I hate the word 'synergy'" — write that down. If they write "the unsexy truth is..." — note that phrase. Their actual words are more valuable than a summary. --- ### Section 4: Content pillars What topics does this person own? - **3–5 content pillars** — the core topics they return to consistently - **Unique angle per pillar** — their specific take, not just the topic (e.g., not "marketing" but "why most marketing advice is wrong for early-stage founders") - **Why they own this topic** — experience, expertise, or lived perspective that gives them credibility or distinctiveness Example questions to ask: - "If someone followed you for 6 months, what 3–5 topics would they expect you to cover?" - "What's your most contrarian or distinctive take in your field?" --- ### Section 5: Platform configuration Where do they post, and what are they trying to do? For each platform they use, capture: - **Platform name** (LinkedIn, Twitter/X, Threads, Bluesky) - **Primary goal** — grow audience / build authority / drive leads / engage community / stay visible - **Current posting frequency**
When the user wants to track follower growth, understand what drives new followers, or analyze audience development. Also use when the user mentions 'follower growth,' 'followers,' 'audience growth,' 'gaining followers,' 'losing followers,' 'who follows me,' or 'grow my audience.' Uses BlackTwist follower data when available. For post-level metrics, see performance-analyzer-sms. For content patterns, see content-pattern-analyzer-sms.
When the user wants to write a caption for a visual-first social media post on Facebook, Instagram, TikTok, Pinterest, or YouTube. Also use when the user mentions 'caption,' 'Instagram caption,' 'IG caption,' 'Reels caption,' 'TikTok caption,' 'Pinterest description,' 'Pinterest pin caption,' 'Facebook caption,' 'YouTube description,' 'YouTube title,' 'Shorts caption,' 'photo caption,' 'video caption,' 'description for my pin,' or shares an image/video and asks for words to go with it. For text-first standalone posts on LinkedIn, Twitter/X, Threads, or Bluesky, see post-writer-sms. For multi-slide carousels, see carousel-writer-sms. For opening lines, see hook-writer-sms.
When the user wants to write content for a LinkedIn carousel, Instagram carousel, Facebook carousel, TikTok photo carousel, Pinterest Idea Pin, or any swipeable multi-slide format. Also use when the user mentions 'carousel,' 'slides,' 'LinkedIn carousel,' 'Instagram carousel,' 'IG carousel,' 'photo carousel,' 'TikTok photo carousel,' 'Idea Pin,' 'Pinterest Idea Pin,' 'swipe post,' 'slide deck,' or 'visual content.' Outputs slide-by-slide text content (not visual design). For single posts, see post-writer-sms. For threads, see thread-writer-sms. For caption copy under each slide post, see caption-writer-sms.
When the user wants to plan a posting schedule, create a content calendar, or organize when and what to post. Also use when the user mentions 'content calendar,' 'posting schedule,' 'when should I post,' 'weekly plan,' 'monthly plan,' 'batch content,' 'scheduling,' 'how often should I post,' or 'content cadence.' For deciding what topics to cover, see content-strategy-sms. For writing the actual posts, see post-writer-sms.
When the user wants to find patterns in what content works and what doesn't. Also use when the user mentions 'what's working,' 'content patterns,' 'best topics,' 'best format,' 'best time to post,' 'analyze my content,' 'do more of,' 'do less of,' or 'what should I change.' For raw metrics, see performance-analyzer-sms. For audience-specific analysis, see audience-growth-tracker-sms. For actionable recommendations, see optimization-advisor-sms.
When the user wants to turn one piece of content into multiple formats or adapt content across text-first and visual-first platforms (LinkedIn, Twitter/X, Threads, Bluesky, Facebook, Instagram, TikTok, Pinterest, YouTube). Also use when the user mentions 'repurpose,' 'turn this into,' 'adapt this for,' 'cross-post,' 'reformat,' 'blog to social,' 'newsletter to posts,' 'video to posts,' 'YouTube to clips,' 'Reels from a podcast,' or 'get more from this content.' For writing original posts, see post-writer-sms. For threads, see thread-writer-sms. For carousels, see carousel-writer-sms. For visual-first captions, see caption-writer-sms.
When the user wants to plan a social media content strategy, decide what to post, or figure out topic clusters and content mix. Also use when the user mentions 'content strategy,' 'what should I post,' 'content ideas,' 'topic clusters,' 'content pillars,' 'content planning,' 'content mix,' 'I don't know what to post,' or 'social media strategy.' Use this to define the what and why of posting. For writing actual posts, see post-writer-sms. For scheduling, see content-calendar-sms. For platform-specific tactics, see platform-strategy-sms.
When the user wants help writing opening lines, hooks, first sentences, video hooks, thumbnails titles, or pin titles that grab attention. Also use when the user mentions 'hook,' 'opening line,' 'first line,' 'scroll stopper,' 'attention grabber,' 'headline,' 'video hook,' 'on-screen hook,' 'YouTube title,' 'thumbnail text,' 'pin title,' 'how to start my post,' or 'nobody reads past my first line.' Covers text-first platforms (LinkedIn, Twitter/X, Threads, Bluesky) and visual-first platforms (Facebook, Instagram, TikTok, Pinterest, YouTube). Can be used standalone or invoked by other creation skills. For writing full posts, see post-writer-sms. For threads, see thread-writer-sms.