Agent skill

Social Media Context Sms

by blacktwist in blacktwist/social-media-skills

When the user wants to set up or update their social media profile, voice, audience, content pillars, or platform preferences.

MITAuto-check passedWriting & Content

Install Social Media Context Sms

skills CLI
$ npx skills add blacktwist/social-media-skills --skill social-media-context-sms -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install blacktwist/social-media-skills social-media-context-sms --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/blacktwist/social-media-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/social-media-context-sms .claude/skills/social-media-context-sms && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
social-media-context-sms
GitHub stars
560
Token cost
~3.1k tokens
SKILL.md length
1,415 words
Files
2
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

When the user wants to set up or update their social media profile, voice, audience, content pillars, or platform preferences.

  • Works in 5 steps: Check for existing context → Choose a setup path → Gather information → …
  • Wants to set up
  • SKILL.md covers When to Use, Purpose, Step 1 — Check for existing… and Step 2 — Choose a setup path, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Social Media Context Sms is an agent skill from blacktwist/social-media-skills. When the user wants to set up or update their social media profile, voice, audience, content pillars, or platform preferences. Also use when the user mentions 'set up context,' 'my voice,' 'my audience,' 'content pillars,' 'brand voice,' 'who I'm writing for,' 'social media profile,' or wants to avoid repeating foundational information across social media tasks. Use this at the start of any new project before using other social media skills — it creates .agents/social-media-context-sms.md that all other skills…

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files.

It sits in Writing & Content, covering Content strategy and Brand voice and tone. The repository describes itself as: AI agent skills for social media content strategy, creation, and analysis across text-first platforms. The licence is MIT.

When your agent uses it

  • Wants to set up
  • Update their social media profile
  • Content pillars
  • Platform preferences

Example prompts

  • “set up context,”
  • “my voice,”
  • “my audience,”
  • “/social-media-context-sms”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Check for existing context
  2. Choose a setup path
  3. Gather information
  4. Write the context file
  5. Confirm and save

What it can do on your machine

Read from SKILL.md and the folder at commit 4f85b07. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Social Media Context Sms loads about 3.1k tokens when it runs. Until then it costs about 138 tokens; SKILL.md has 1,415 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~138
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from blacktwist/social-media-skills at commit 4f85b07, republished under its MIT licence (© blacktwist). 1,415 words, ~3,134 tokens.

Download SKILL.mdSave it as .claude/skills/social-media-context-sms/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
social-media-context-sms
description
When the user wants to set up or update their social media profile, voice, audience, content pillars, or platform preferences. Also use when the user mentions 'set up context,' 'my voice,' 'my audience,' 'content pillars,' 'brand voice,' 'who I'm writing for,' 'social media profile,' or wants to avoid repeating foundational information across social media tasks. Use this at the start of any new project before using other social media skills — it creates .agents/social-media-context-sms.md that all other skills reference.
metadata.version
1.0.0

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?"

Show full SKILL.md (602 more words)Show less
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 — how often they actually post
  • Target posting frequency — how often they want to post
  • Connected via BlackTwist? — yes / no (used by other skills for tool integration)

Example questions to ask:

  • "Which platforms are you currently active on?"
  • "What do you want each platform to do for you — are they all serving the same goal, or different ones?"

Section 6: Content formats

How do they like to communicate?

  • Formats they use — standalone posts, threads/tweet storms, carousels, polls, long-form articles
  • Preferred format per platform — what tends to work well for them
  • Formats they avoid — formats they've tried and don't like, or don't fit their style

Example questions to ask:

  • "Do you prefer writing short punchy posts or longer threads?"
  • "Any formats you've tried and never want to do again?"

Section 7: Example posts

The most important section for voice matching.

Ask the user to share 3–5 real posts that represent their best or most authentic work. These are used by all creation skills to match their style.

  • Copy them verbatim — do not summarize or clean them up.
  • Note which platform each is from.
  • Note what made each one good (in the user's words, if they say).

If they can't share posts yet:

  • Ask for a rough draft of something they'd write
  • Or proceed without examples and note this section is incomplete

Section 8: Anti-patterns

What to avoid.

  • Topics off limits — subjects they won't touch (competitors, politics, personal life, etc.)
  • Tones that don't fit — styles that feel wrong (preachy, hype-y, vulnerable, motivational-poster, etc.)
  • Content types they won't create — formats or content categories they actively want to avoid

Example questions to ask:

  • "Is there anything I should never write for you, no matter the topic?"
  • "What's a post you've seen in your niche that made you cringe?"

Example anti-patterns section:

Topics to avoid: Competitor comparisons, partisan politics, personal health
Tones to avoid: Preachy, hype-y, motivational-poster, "rise and grind"
Content types to avoid: Memes, engagement-bait polls, "agree?" one-liners

Step 4 — Write the context file

Once you have enough information (at minimum: identity, audience, voice, and at least one platform), create or update .agents/social-media-context-sms.md using this exact template:

markdown
# Social Media Context

last_updated: YYYY-MM-DD

---

## Identity

- **Type**: [Creator / Brand / Client account]
- **Name**: [Full name or brand name]
- **Handle(s)**: [Platform handles, e.g. @handle on LinkedIn]
- **Role**: [How they describe what they do]
- **Industry/niche**: [Specific space they operate in]
- **Positioning**: [One-line differentiator]

---

## Target Audience

- **Primary audience**: [Description]
- **Pain points**: [What they struggle with]
- **Goals**: [What they want]
- **Sophistication level**: [Beginner / Intermediate / Expert]
- **Where they hang out**: [Platforms and context]

---

## Voice & Tone

- **Voice adjectives**: [3–5 words]
- **Formality**: [Casual / Semi-formal / Professional]
- **Humor**: [None / Dry / Occasional / Frequent]
- **Phrases to use**: [Actual phrases/expressions from the user]
- **Phrases to avoid**: [Jargon, tones, expressions that feel off]

---

## Content Pillars

1. **[Pillar name]** — [Unique angle]
2. **[Pillar name]** — [Unique angle]
3. **[Pillar name]** — [Unique angle]
[Add more as needed]

---

## Platform Configuration

| Platform | Goal | Current Frequency | Target Frequency | BlackTwist |
|---|---|---|---|---|
| [Platform] | [Goal] | [e.g. 3x/week] | [e.g. 5x/week] | [Yes / No] |

---

## Content Formats

- **Preferred formats**: [List]
- **Per-platform preferences**: [Any platform-specific notes]
- **Formats to avoid**: [List]

---

## Example Posts

### Example 1 — [Platform]
[Verbatim post text]

### Example 2 — [Platform]
[Verbatim post text]

[Add more as needed]

---

## Anti-Patterns

- **Topics to avoid**: [List]
- **Tones to avoid**: [List]
- **Content types to avoid**: [List]

Step 5 — Confirm and save

After drafting:

  1. Show the user the full file contents.
  2. Ask: "Does this capture your context accurately? Any sections to adjust?"
  3. Apply revisions.
  4. Save to .agents/social-media-context-sms.md.
  5. Confirm: "Context saved. All other social media skills will now read from this file."

Maintenance

The user can update any section at any time by running this skill again. When updating:

  • Read the existing file first.
  • Ask which section needs updating.
  • Edit only that section — leave the rest untouched.
  • Update the last_updated date.

Common update triggers:

  • Expanding to a new platform → update Platform Configuration
  • Refining their voice after seeing what works → update Voice & Tone and Example Posts
  • Shifting their niche or audience → update Identity and Target Audience
  • Dropping a topic → update Content Pillars and Anti-Patterns

Boundaries

  • Does not write posts, threads, or carousels — see post-writer-sms, thread-writer-sms, or carousel-writer-sms for content creation
  • Does not build a content strategy or define topic clusters — see content-strategy-sms for strategic planning
  • Does not analyze performance or metrics — see performance-analyzer-sms for analytics
  • Does not schedule or plan a content calendar — see content-calendar-sms for scheduling
  • Does not execute code or access external APIs unless BlackTwist MCP is connected
  • Does not make strategic recommendations — this skill captures identity and preferences only

See also

content-strategy-sms — builds a content framework from your pillars and audience platform-strategy-sms — develops platform-specific tactics from your context post-writer-sms — writes individual posts using your voice profile

© blacktwist, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/social-media-context-sms of blacktwist/social-media-skills.

  • SKILL.md
  • evals/.gitkeep

Open the folder on GitHubat commit 4f85b07

Compare with similar skills

Social Media Context Sms next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Social Media Context Sms compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Social Media Context Sms this skillblacktwist/social-media-skills560—~3.1kAutomated safety check: PassMIT
Brand Voice Content Creatordavila7/claude-code-templates33k3 repos~1.9kAutomated safety check: PassMIT
Ralph Copywritermuratcankoylan/ralph-wiggum-marketer778—~2.4kAutomated safety check: PassNone
Liu Run Style Business Column Writerliangdabiao/liurun-bookwriter-skills277—~1.8kAutomated safety check: PassMIT
Caption Writerstevenflanagan1/social-ai-team244—~2.9kAutomated safety check: PassNone
Content Creatorthatrebeccarae/claude-marketing161—~1.1kAutomated safety check: PassMIT

Similar skills

  • Brand Voice Content Creator

    davila7/claude-code-templates

    Analyzes a brand's existing writing to lock in a consistent voice, then builds SEO blog posts and platform-specific social content around it.

    33k GitHub starsUsed in 3 repos~1.9k tokens
    Writing & ContentAuto-check passed
  • Ralph Copywriter

    muratcankoylan/ralph-wiggum-marketer

    A skill your agent uses when the user asks to "analyze my content", "learn my writing style", "research competitors", "find content angles", "improve my blog", "write like me", "embody my brand…

    778 GitHub stars~2.4k tokensUpdated 6 mo ago
    Writing & ContentAuto-check passed
  • Liu Run Style Business Column Writer

    liangdabiao/liurun-bookwriter-skills

    Writes long-form Chinese business commentary in Liu Run's voice, using his eight writing principles, three structures, and SCQA logic patterns.

    277 GitHub stars~1.8k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Caption Writer

    stevenflanagan1/social-ai-team

    Writes on-brand social media captions for SMBs. An agent skill from stevenflanagan1/social-ai-team.

    244 GitHub stars~2.9k tokensUpdated 4 days ago
    Writing & ContentAuto-check passed
  • Content Creator

    thatrebeccarae/claude-marketing

    Comprehensive content marketing toolkit with brand voice analysis, SEO optimization scripts, content frameworks, social media strategy, and content calendar planning.

    161 GitHub stars~1.1k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • Content Creator

    sickn33/agentic-awesome-skills

    Drafts and reviews audience-specific content from supplied brand examples, with local scripts for brand voice and SEO diagnostics, channel templates and a content calendar.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Writing & ContentAuto-check passed

More from blacktwist/social-media-skills

All 14 skills in this repo
  • Content Pattern Analyzer Sms

    blacktwist/social-media-skills

    When the user wants to find patterns in what content works and what doesn't.

    560 GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • Audience Growth Tracker Sms

    blacktwist/social-media-skills

    When the user wants to track follower growth, understand what drives new followers, or analyze audience development.

    560 GitHub stars~3.6k tokensUpdated 5 mo ago
    Auto-check passed
  • Carousel Writer Sms

    blacktwist/social-media-skills

    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.

    560 GitHub stars~4.1k tokensUpdated 5 mo ago
    Auto-check passed
  • Content Calendar Sms

    blacktwist/social-media-skills

    When the user wants to plan a posting schedule, create a content calendar, or organize when and what to post.

    560 GitHub stars~2.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Content Repurposer Sms

    blacktwist/social-media-skills

    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…

    560 GitHub stars~3.7k tokensUpdated 5 mo ago
    Auto-check passed
  • Content Strategy Sms

    blacktwist/social-media-skills

    When the user wants to plan a social media content strategy, decide what to post, or figure out topic clusters and content mix.

    560 GitHub stars~2.7k tokensUpdated 5 mo ago
    Auto-check passed

Questions about Social Media Context Sms

What does Social Media Context Sms do?

When the user wants to set up or update their social media profile, voice, audience, content pillars, or platform preferences. Social Media Context Sms is an agent skill from blacktwist/social-media-skills. When the user wants to set up or update their social media profile, voice, audience, content pillars, or platform preferences.

When should I use Social Media Context Sms?

Social Media Context Sms fits situations like: wants to set up; update their social media profile; content pillars; platform preferences.

How do I install Social Media Context Sms in Claude Code?

Run `npx skills add blacktwist/social-media-skills --skill social-media-context-sms -a claude-code`. Or copy the skill folder (skills/social-media-context-sms in blacktwist/social-media-skills) into .claude/skills/social-media-context-sms in your project. Claude Code loads it when a task matches its description.

How do I install Social Media Context Sms in Codex?

Run `npx skills add blacktwist/social-media-skills --skill social-media-context-sms -a codex`. Or copy the skill folder (skills/social-media-context-sms in blacktwist/social-media-skills) into .agents/skills/social-media-context-sms in your project. Codex loads it when a task matches its description.

Can I use Social Media Context Sms in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add blacktwist/social-media-skills --skill social-media-context-sms -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/social-media-context-sms, .gemini/skills/social-media-context-sms, .github/skills/social-media-context-sms and .opencode/skills/social-media-context-sms in your project.

What does Social Media Context Sms need to run?

SKILL.md names no scripts, command-line tools or credentials: Social Media Context Sms is instructions for the agent only.

Does Social Media Context Sms access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Social Media Context Sms safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Social Media Context Sms use?

Social Media Context Sms is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Social Media Context Sms use?

About 3.1k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Social Media Context Sms?

Skills that share tags, products or a category with Social Media Context Sms: Brand Voice Content Creator (davila7/claude-code-templates, 33k stars), Ralph Copywriter (muratcankoylan/ralph-wiggum-marketer, 778 stars), Liu Run Style Business Column Writer (liangdabiao/liurun-bookwriter-skills, 277 stars) and Caption Writer (stevenflanagan1/social-ai-team, 244 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Social Media Context Sms?

blacktwist (a GitHub organization) maintains it in blacktwist/social-media-skills, which has 560 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on May 1, 2026.

Source: blacktwist/social-media-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.