# Social media context Human Guide

## What This Is For
When the user wants to set up or update their social media profile, voice, audience, content pillars, or platform preferences. It gives the agent a clearer input/output frame for social content: what context to ask for, what decisions to make, and what usable artifact to return.

Use this as a human-readable version of the Social media context agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions.

## When To Use This
- Use this when you need a repeatable process for social media context.
- Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt.
- Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact.

## When Not To Use This
- Do not use this when you only need a quick factual answer.
- Do not use this when the work depends on private data you cannot share with the assistant.
- Do not use this as a replacement for legal, compliance, financial, or medical review.

## What You Need Before Starting
- The goal or business outcome you want.
- The audience, customer segment, or market context.
- Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance.
- Constraints such as tone, length, channel, deadline, region, or approval requirements.
- A clear definition of what a good final answer should look like.

## Step-By-Step Workflow
1. State the job clearly: "Use the Social media context guide to help me with..."
2. Add context: audience, goal, offer, channel, source material, and constraints.
3. Ask the assistant to identify missing inputs before producing the final output.
4. Have the assistant follow the skill-specific guidance below.
5. Review the result against the final checklist and ask for revisions where needed.

## Skill-Specific Guidance
- 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
- Summarize what is already captured (2–3 sentences).
- Ask: "What would you like to update? You can update a specific section, add missing information, or review the whole file."
- Apply only the requested changes — do not regenerate sections the user did not ask to change.
- Update the `last_updated` field at the top of the file.
- **Creator or brand?** (Personal account / company / client account)
- **Name and handle(s)** — full name, preferred name, username(s) per platform

## Decision Points And Nuance
The original skill emphasizes: When to Use, Purpose, Step 1 — Check for existing context, Step 2 — Choose a setup path, Step 3 — Gather information, Section 1: Identity, Section 2: Target audience, Section 3: Voice & tone, Section 4: Content pillars, Section 5: Platform configuration.

Use these questions to steer the work:
- What is the intended audience or buyer?
- What source material must be preserved?
- What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion?
- What examples represent the desired quality bar?
- What should the assistant avoid?

## Common Mistakes
- User mentions "social media profile" or wants to avoid repeating foundational info
- Apply only the requested changes — do not regenerate sections the user did not ask to change.
- Do not move through all sections at once. Ask, receive, confirm — then move to the next.
- "What do you do that most people in your field don't?"
- **What they already know** — sophistication level; avoid over-explaining or under-explaining
- **Phrases to avoid** — corporate jargon, buzzwords, tones that feel fake or off-brand
- "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?"

## Copy-And-Paste Prompt
```text
Use the Social media context human guide.

My goal:
[Describe the business outcome]

Audience:
[Describe who this is for]

Context and source material:
[Paste notes, examples, links, or existing copy]

Constraints:
[Tone, length, channel, timeline, must-include items, must-avoid items]

Before producing the final output, ask me for any missing information that would materially improve the result.
```

## Final Checklist
- [ ] The output matches the original goal.
- [ ] The audience and context are reflected in the answer.
- [ ] Important constraints and source material were preserved.
- [ ] The assistant made the relevant decisions explicit.
- [ ] The final artifact is ready to use, review, or hand to the next person.

## Source
This guide was generated from the blacktwist/social-media-skills skill entry for `social-media-context-sms`.

## Source Skill Notes
These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic.

## 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: