# Mb Skill Brief Draft

> Compose a site brief from offer.md + audience.md + voice.md + research files + the operator's dial / archetype picks. Used by /mb-site as the brief-drafting step. Loadable independently for /mb-ads, /mb-organic, or sales-video workflows if they want to share the same brief shape.

- Skill: `noontide-co/mb-skill-brief-draft` (Agent Skill, multi-file: 12 files)
- Install (CLI): `npx skillmds@latest add noontide-co/mb-skill-brief-draft`
- Raw SKILL.md: https://api.skillmd.com/api/skills/noontide-co/mb-skill-brief-draft/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: noontide-co (https://skillmd.com/u/noontide-co)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/noontide-co/mb-skill-brief-draft

---


# skill-brief-draft

A composable skill for drafting a site / campaign brief. /mb-site calls this in Step 2 of the minisite flow. /mb-ads, /mb-organic, or sales-video workflows *may* call it later; for now it is only used by /mb-site.

## Inputs

- `offer.md`, `audience.md`, `voice.md` (resolved via `mb resolve`)
- `research/*.md` produced earlier in the flow
- Operator picks: `dial`, `archetype` (optional), `audience_current_archetype` (optional)
- Picked headline formulas (2-3 from `references/headline-formulas.md`)

## Outputs

A single markdown artifact: `decisions/YYYY-MM-DD-minisite-brief-<slug>.md` with the v0.1 schema:

```yaml
---
type: brief
date: YYYY-MM-DD
slug: <offer-slug>
status: proposed
dial: convert | story | brand
conversion_mechanism: lead_form | book_call | purchase | other
takes_calls: true | false
archetype: ...
audience_current_archetype: ...
copy_framework_tag: ...
headline_formulas_picked: [...]
do_not_state: [...]
four_forces: {push, pull, habit, anxiety}
voice_anchor_lines: {use: [...], avoid: [...]}
---
```

`conversion_mechanism` and `takes_calls` are operator-stated facts, not guesses — see the gate in Flow step 0.

Plus the body sections: headline + subhead, value prop, mechanism summary, picked supporting pages, conversion endpoint, adjacency map.

## Flow

0. **Conversion-mechanism gate (before any copy).** Pin what the visitor does
   to convert — submit a lead form, book a call, buy — and specifically whether
   the operator takes calls. This is an operator-stated fact: if it is not
   already recorded (in `offer.md`, a prior decision, or the operator's own
   words this session), STOP and ask before drafting. Never assume a model —
   the headline, value prop, and mechanism summary are all shaped by it, so a
   wrong guess rewrites the whole brief. A real business we built lost a full
   day when an agent invented a call-booking flow the operator never chose.
   Record the answer in `conversion_mechanism` + `takes_calls`.
1. **Read inputs.** Resolve offer/audience/voice; load picked archetype detail file.
2. **Compose schema header.** Fill in fields from operator picks, including the
   gated `conversion_mechanism` + `takes_calls`.
3. **Draft headline + subhead.** Apply one of the picked formulas. Aim for ≤ 2 lines.
4. **Draft value prop.** 3 short reasons OR one extended argument. Match the dial.
5. **Draft mechanism summary.** For the how-it-works page.
6. **Pick supporting pages.** 2-4 from proof / pricing / faq / about.
7. **Build adjacency map.** Per Hughes paired-imagery rule, name two images per section.
8. **Hand off to skill-review** with the dial.

## Cross-references

- [references/archetypes.md](references/archetypes.md)
- [references/headline-formulas.md](references/headline-formulas.md)
- `skill-review` composable skill