• BRAND.md

  : who the audience is, what the brand stands for, what to never say

• VOICE.md

  : how the brand sounds, structurally and lexically

• Primary audience role (e.g. "head of marketing at a 50-500 person B2B SaaS")
• Secondary audience (optional)
• Reader expertise level: beginner / intermediate / advanced / mixed
• Problems the reader is actively trying to solve (3 to 5 bullets)
• Common misconceptions the audience holds (used to anchor information gain)

• One-sentence brand mission (what the brand helps people do)
• Distinctive point of view (the contrarian or non-obvious belief that shapes content)
• What this brand is NOT (anti-positioning, what to never be confused with)
• Top 3 direct competitors with the one-line differentiator vs each

• Do list (3 to 7 things the blog will always do; e.g. "cite primary sources only," "name the practitioner not the product")
• Don't list (3 to 7 things the blog will never do; e.g. "no clickbait titles," "no listicle filler")
• Taboo phrases (specific words or phrases this brand never uses; complements but is separate from the AI-detection blocklist)
• Required disclosures (e.g. affiliate disclosure, AI-content disclosure, conflict-of-interest patterns)

• Topics fully in scope (core content pillars)
• Topics partially in scope (adjacent; covered only with original angle)
• Topics out of scope (will not cover; redirect to partner content)
• Recurring formats / column names if any (e.g. "Monthly Field Notes," "Reader Q&A")

• Pronoun stance: first-person (we / I), second-person (you), third-person (the team), or mixed
• Acceptable contractions: full / partial / none
• Sentence ceiling: max words per sentence as a hard cap
• Paragraph ceiling: max words per paragraph (default 150)
• Headline patterns to favor: numbered / question / promise / statement
• Headline patterns to avoid: any patterns banned for this brand
• Summary box label: from blog-persona, or pick one

This file is auto-loaded by all blog sub-skills. Last updated: YYYY-MM-DD.

• Primary: [role + context]
• Secondary: [if any]
• Expertise: [level]
• Active problems:
  • [problem 1]
  • [problem 2]
  • [problem 3]
• Common misconceptions:
  • [misconception 1]
  • [misconception 2]

• Mission: [one sentence]
• Distinctive POV: [contrarian or non-obvious belief]
• What we are NOT: [anti-positioning]
• Competitors:
  • [Competitor A]: [our one-line differentiator]
  • [Competitor B]: [our one-line differentiator]
  • [Competitor C]: [our one-line differentiator]

• [rule 1]
• [rule 2]
• [rule 3]

• [rule 1]
• [rule 2]
• [rule 3]

• [phrase 1]
• [phrase 2]

• [disclosure rule]

• In scope: [pillars]
• Partial scope: [adjacent topics]
• Out of scope: [topics to refuse]
• Recurring formats: [if any]

undefined

This file is auto-loaded by all blog sub-skills. Last updated: YYYY-MM-DD.

• Contractions: [full / partial / none]
• Sentence ceiling: [N words max]
• Paragraph ceiling: [N words max, default 150]
• Summary label: [Key Takeaways / TL;DR / etc.]

• Favor: [list]
• Avoid: [list]

• Funny vs serious: [0.0 to 1.0]
• Formal vs casual: [0.0 to 1.0]
• Respectful vs irreverent: [0.0 to 1.0]
• Enthusiastic vs matter-of-fact: [0.0 to 1.0]

• Audience tier: [consumer / professional / technical]
• Flesch Grade: [range]
• Flesch Ease: [range]

• [URL 1] (extracted patterns: [summary])
• [URL 2] (extracted patterns: [summary])

undefined

1. Check for

   BRAND.md

   and

   VOICE.md

   at project root.
2. If both exist, print a summary table (key sections only) and the file paths.
3. If one or both are missing, print which are missing and suggest

   /blog brand init

   .

• Project root unclear: ask the user where to write the files. Default is the current working directory.
• Files already exist on init: ask whether to overwrite or run update instead.
• Persona referenced but missing: ask whether to leave the persona reference blank or create one.
• Reader provides minimal answers: prompt for at least 2 audience bullets and 3 editorial rules; refuse to write skeletons.