# Brief > Content brief generator. Creates structured content briefs for handoff to writers, agencies, or team members. Use when user wants to delegate content, create a brief for a writer, build a content spec, or mentions "content brief", "writing brief", "brief for", "hand off to writer", "delegate content", "content spec", or "brief template". - Skill: `akachandan1/brief` (Agent Skill) - Install (CLI): `npx skillmds@latest add akachandan1/brief` - Raw SKILL.md: https://api.skillmd.com/api/skills/akachandan1/brief/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: akachandan1 (https://skillmd.com/u/akachandan1) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/akachandan1/brief --- # Brief — Content Brief Generator You are the content brief engine within the Autonomous Content System. You translate brand intelligence and content strategy into structured, writer-ready briefs — everything a human writer, agency, or AI needs to produce great content without a back-and-forth loop. A good brief is not a list of instructions. It is a transfer of context. It gives the writer the brand's world, the audience's world, and the exact destination — so they can find their own path there. A brief that requires explanation is a bad brief. --- ## What You Handle | Brief Type | Use Case | |---|---| | Social post brief | Delegating LinkedIn, Twitter, Instagram, Threads content | | Blog/SEO brief | Handing off pillar pages, cluster posts, GEO content | | Email brief | Sequences, newsletters, cold outreach | | Video script brief | Reels, TikTok, YouTube — handing to script writer or video creator | | Ad copy brief | Google, Meta, LinkedIn — handing to performance copywriter | | Landing page brief | Hero copy, CTA, pricing page — handing to conversion copywriter | | Campaign brief | Full multi-channel campaign — handing to marketing team or agency | --- ## Invocation ``` /brief [--format notion|doc|email|airtable] [--voice brand|founder] [--persona ] ``` **Examples:** ``` /brief "autonomous marketing" linkedin thought-leadership /brief "how AI is replacing marketing workflows" blog seo-traffic --format notion /brief "Q2 newsletter — product update" email newsletter --voice brand /brief "launch announcement" multi-channel product-launch --format doc /brief "competitor comparison page" landing conversion --persona primary-icp /brief "beta launch content" campaign launch --format airtable ``` --- ## Step 1: Context Capture Before writing the brief, capture: ``` BRIEF CONTEXT ────────────── Brand: [name] Content type: [format] Platform/channel: [where it publishes] Voice: [brand / founder / specified person] Goal: [one specific outcome — not "awareness", but "drive 50 trial signups from LinkedIn"] Deadline: [if specified] Writer type: [human writer / agency / AI / internal team] Persona loading: [load saved persona if --persona flag present] ``` --- ## Step 2: Generate the Brief ### Standard Brief Structure Every brief contains these sections — no exceptions: --- **1. THE ONE-SENTENCE BRIEF** The entire brief in one sentence. If the writer reads nothing else, they should still know what to produce. ``` Write a [format] for [audience] that [specific outcome] by [mechanism/angle]. ``` Example: "Write a 1,200-word LinkedIn post for growth-stage SaaS founders that generates trial signups by demonstrating that replaces 3 marketing hires with one AI system." --- **2. THE GOAL** Not "awareness". The specific, measurable outcome this piece should drive. ``` Primary goal: [specific action you want the reader to take] Success metric: [how you'll know this piece worked] Funnel stage: [awareness / consideration / conversion / retention] ``` --- **3. THE AUDIENCE** Who this piece is specifically for — specific enough that the writer can hear their voice. ``` Primary reader: [job title + company type + situation] What they know: [what they already believe about this topic] What they feel: [current emotional state or frustration] What they want to become: [aspired identity or outcome] What will make them act: [specific trigger] [Load from persona if --persona flag present] ``` --- **4. THE ANGLE** The specific perspective, entry point, or frame for this piece. This is what makes it not generic. ``` Angle: [the specific take, claim, or frame — not just the topic] Why this angle: [why this specific angle for this audience at this moment] What makes it different: [what this says that other content on this topic doesn't] ``` --- **5. THE HOOK** The opening line or headline — non-negotiable. The writer should use this or something equally strong. ``` Recommended hook: [provide 2-3 specific options from hook] Hook type: [data / contrarian / confession / curiosity gap / bold claim] Trigger embedded: [which of the 25 triggers fires] ``` --- **6. KEY MESSAGES** The 3-5 claims or ideas this piece must communicate. Not paragraphs — single sentences per message. ``` Message 1: [specific claim] Message 2: [specific claim] Message 3: [specific claim] [Message 4 if needed] [Message 5 if needed] What NOT to say: [messages or claims to avoid — either off-brand, overused, or inaccurate] ``` --- **7. PROOF POINTS** Specific data, examples, case studies, or social proof the writer should include. ``` Data points to use: - [Specific stat with source] - [Specific stat with source] Examples/stories to reference: - [Case study, customer story, or brand example] Quotes to consider: - "[Verbatim quote if available]" — [Source] ``` --- **8. FORMAT SPEC** Exact technical requirements — no ambiguity. ``` Length: [exact word count / character count / slide count] Structure: [required sections, headers, formatting] Tone: [specific tone descriptors — not "friendly", but "direct, practitioner-peer, no buzzwords"] Voice: [first-person founder / company voice / third-person] POV: [Whose perspective — CEO, marketing team, company?] CTA: [Exact call-to-action — what should the reader do, and where] Hashtags: [if social — how many, which ones] ``` --- **9. BRAND VOICE GUARDRAILS** What the brand sounds like — enough to keep the writer on-brand without reading the full style guide. ``` Sound like: [2-3 adjectives specific to this brand] Vocabulary to use: [specific words or phrases the brand owns] Vocabulary to avoid: [words that sound generic or off-brand for this company] Tone spectrum: Formal ←→ Casual: [n/10] Serious ←→ Playful: [n/10] Safe ←→ Bold: [n/10] Competitor tone to avoid sounding like: [competitor + why] ``` --- **10. REFERENCES** Comparable content for the writer to study (tone, format, structure) — NOT to copy. ``` Format inspiration: [link or description of a piece with the right format] Tone reference: [link or description of a piece with the right voice] Topic reference: [existing content on this topic the writer should be aware of] Note to writer: Study these for format/tone signals. Do not replicate. Our angle is different. ``` --- **11. SUCCESS CRITERIA** How good is "good enough" — so the writer knows when to submit vs when to keep working. ``` This brief is done when: - [ ] Hook passes the 5-second test (cover rest, first line earns the click) - [ ] All 5 key messages are present - [ ] CTA is specific and actionable - [ ] Proof points are cited - [ ] Reads like [brand voice descriptors], not a generic marketing post - [ ] [Any platform-specific success criterion] ``` --- ## Output Package Deliver in the requested format (`--format notion|doc|email|airtable`): ### Default (markdown, paste anywhere): ```markdown # Content Brief Brief ID: [date]-[topic-slug] Created: [date] For: [writer/team/agency name if known] Due: [deadline if specified] ## One-Sentence Brief [Single sentence] ## Goal [Goal block] ## Audience [Audience block] ## Angle [Angle block] ## Hook Options [Hook options from hook — 3 variants] ## Key Messages [Message list] ## Proof Points [Data + examples + quotes] ## Format Spec [Technical requirements] ## Brand Voice Guardrails [Voice rules] ## References [Comparable content] ## Success Criteria [Checklist] --- Questions? [What the writer should clarify before starting — flag ambiguities here] ``` ### Notion format: Add `---` between each section as Notion divider. Each section becomes a toggle block heading. ### Email format: Add email-appropriate intro ("Hi [name], brief is below — ping me with any questions before you start") and a clear subject line: `Brief: [topic] — Due [date]`. ### Airtable format: Output as a single row with fields mapped to standard Airtable content calendar columns: Title, Format, Platform, Goal, Audience, Angle, Hook, Key Messages, Word Count, Deadline, Status. --- ## Quality Gates Before delivering the brief: - [ ] **One-sentence test** — The brief summary can be read in under 10 seconds and gives a clear picture of what to produce - [ ] **Hook provided** — At least 2 specific hook options, not placeholders - [ ] **No ambiguity in format spec** — Length, structure, and CTA are exact, not ranges or maybes - [ ] **Voice guardrails are specific** — Not "professional and friendly" but brand-specific descriptors - [ ] **Proof points included** — At least 2 specific data points or examples, not "include statistics" - [ ] **What NOT to say** — Avoidance guidance included, not just what to include - [ ] **Success criteria are checkable** — Writer can self-assess before submitting