Marketing Skill
A rigorous, end-to-end marketing skill. It does two things well: produces sharp, ready-to-use
deliverables (copy, briefs, plans) and applies disciplined strategy frameworks so the output is
grounded rather than generic. The defining principle of this skill is that good marketing is specific,
evidence-led, and built around the reader — not the brand.
This file is the orchestration layer. It tells you how to approach any marketing task and routes you to
the right deep-dive reference. Read the relevant reference file(s) in references/ before producing a
deliverable in that area — they contain the detailed frameworks, checklists, formulas, and quality bars
that make the difference between competent and excellent output.
How to use this skill
Step 0 — Check for a brand profile. If the project contains a brand.md (project root, or next to
this skill), read it before anything else. It is the user's standing brief — company, audience, voice
and tone rules, and proof on file (real stats, testimonials, case studies). Treat its contents as ground
truth for the five brief elements below: don't re-ask what it already answers, draw proof from its
"proof on file" section instead of using placeholders, and follow its voice rules in every deliverable.
Anything the user says in-session overrides it.
If there is no brand.md, proceed normally — but watch for the moment to start one. Whenever the user
volunteers durable brand facts in-session — their audience, voice or tone rules, a real stat or
testimonial, a positioning or differentiator — deliver what they asked for first, then end your response
by offering to save those facts as a brand.md so they don't have to repeat them next session. This is
not optional politeness; a user who just handed you their voice rules and a sourced stat should always be
offered the profile. The same applies when you find yourself asking scoping questions they've plainly
answered before. Two ways to draft it: (a) fill the template sections (company, audience, voice & tone,
proof on file, standing constraints) from what you've learned in-session, or (b) if you have a web-fetch
tool and the user has a live site, offer to fetch their homepage and draft brand.md from it. Either way,
show the draft and let the user correct it before saving — it's their standing brief, not yours.
Step 0.5 — Ground in product truth when it's at hand. When you're working inside the product's own
repository, or have tools that can see the real thing, use them before guessing. Skim the README, docs,
or landing-page source for what the product actually does, and prefer real feature names, limits, and
numbers over invented ones. The same goes for research tasks: if you have web access, read a
competitor's actual site rather than reasoning about it from memory. Real proof you found beats a
placeholder; a placeholder beats an invention.
Step 1 — Establish the brief before writing. Marketing output is only as good as its inputs. Before
producing anything, make sure you know (or have reasonably inferred and flagged) these five things. This
is the single most important habit in this skill.
- Audience — who specifically is this for? (role, situation, what they believe right now)
- Goal — what one action should this drive? (click, sign-up, purchase, reply, share)
- Offer/product — what is being marketed, and what's the single most important thing about it?
- Proof — what evidence supports the claims? (metrics, testimonials, mechanism, credentials)
- Constraint — channel, length, tone, brand rules, or anything that bounds the output.
If the user hasn't given you these, how you proceed depends on the task. There are two task types where
you must STOP and gather inputs first — do not produce the deliverable on assumptions:
Gate A — Single load-bearing strategy statements (positioning statement, value proposition, messaging
hierarchy, brand voice/tone definition). These are the foundations everything downstream inherits, they
compress to one authoritative artifact, and a plausible-looking guess is worse than no answer because it
reads as fact. ONLY these four hard-stop. Ask 2–3 sharp questions covering the most important unknowns
(almost always: who exactly is this for, what's the single most important differentiator, and who/what is
the main alternative) before writing. Do not output a positioning statement built on guessed inputs.
Everything else that feels strategic — ICPs/personas, content calendars, campaign briefs, launch/GTM
plans — is deliver-first, not a gate. These are multi-part working documents, not a single
load-bearing sentence: a reader skims an assumption-tagged draft and corrects it in seconds, which is far
more useful than a wall of questions. See the deliver-first rules below; do not hard-stop on them.
Gate B — Audits and "improve my X" tasks (audit my landing page, why isn't my email converting, review
my copy, make this better). You cannot meaningfully audit an asset you cannot see — but asking is the
last resort, not the first. If the user gave a URL and you have a web-fetch or browser tool, fetch the
page yourself and audit the live asset. If the asset plausibly lives in the current project (a landing
page in the repo, an email template, README copy), look for it before asking. Only when you cannot see
the asset by any means do you stop and ask the user to share it (paste the copy, share the URL, or upload
a screenshot) plus the goal and audience. If they can't share it, say what you'd need and offer a generic
checklist instead — but make clear a real audit requires seeing the real thing. Do not invent the
contents of the asset and audit your own invention.
For everything else, scale to stakes — and bias hard toward producing something useful rather than
withholding it. The default is deliver-first: state your load-bearing assumptions in one line at the
top, build the real deliverable on them, then optionally append 1–2 sharpening questions. Asking instead
of delivering is the failure mode, not diligence.
- Big working documents (a campaign concept, a content strategy/calendar, a launch or GTM plan, an
ICP or persona): still deliver-first. Open with a one-line assumptions block naming the audience, goal,
and any other inputs you inferred ("Assuming [audience], goal = [X]; adjust if wrong"), then produce the
full structured document — the calendar with all its fields, the phased pre/launch/post plan with its
asset checklist, the ICP with firmographics/pains/triggers. For an ICP or persona, explicitly mark it
as a hypothesis pending real customer evidence, not asserted fact. You may add 2–3 sharpening
questions after the draft, but never withhold the document behind them.
- A concrete copy deliverable (a homepage hero, an ad, a landing-page section, a handful of
subject lines): lead with the copy. Even when the audience or angle is unstated, pick the single
most likely one, name it in a one-line assumption at the top ("Assuming [X]; adjust if wrong"), and
write the deliverable anyway. A concrete draft built on a named assumption is far more useful than a
list of questions: the reader corrects a wrong assumption in seconds, and most of the copy still
holds. For these requests, asking first is the failure mode, not diligence — produce the draft,
then you may add 1–2 optional sharpening questions after it. This is the one place the "never guess
the audience" rule below bends: stating a guess out loud and building on it is exactly what we want;
only a silent, unstated guess is forbidden.
Note the difference from Gate A above: defining the positioning statement, value prop, voice, or
messaging hierarchy is a single load-bearing artifact and still gets gated, because everything downstream
inherits its flaws. But writing the copy that expresses an already-implied position — or building a
working document like a calendar, launch plan, or ICP — is a deliverable: lead with the draft and flag
your assumptions.
Never silently guess on the audience or the goal — those two are load-bearing in every task. Stating
an assumption out loud is fine; hiding one is not.
What a good brief-first ask looks like (keep it to 2–3 questions, make them sharp, don't interrogate):
Before I write this positioning statement, three quick things so it's sharp rather than generic:
- Who exactly is this for — what's the narrowest core audience? (e.g. "agencies of 10–50," not "businesses")
- What's the one thing you do that the main alternatives don't?
- Who or what are you really competing against — a rival tool, a spreadsheet, or just doing nothing?
Then write the deliverable using their answers. If they decline to answer, fall back to stated assumptions
and flag that sharpening the inputs would improve the result.
Step 2 — Route to the right reference. Match the task to the table below, read that reference file,
then produce the deliverable following its frameworks.
Step 3 — Apply the universal quality bar (below) to everything, regardless of task.
Step 4 — Deliver ready-to-use output, then optionally annotate. Write the actual copy or build the
actual plan. Don't hand back a description of what could be written. After the deliverable, you may add a
short "why this works" note or offer variants, but the deliverable comes first.
Routing table
| If the task involves... |
Read this reference |
| Ads, emails, landing pages, homepages, CTAs, taglines, product/sales copy, social posts, any writing |
references/copywriting.md |
| Brand voice, tone, messaging hierarchy, value prop, positioning, boilerplate, naming |
references/brand-messaging.md |
| Content calendars, editorial plans, content pillars, blog/social strategy, repurposing |
references/content-strategy.md |
| Campaign concepts, product launches, GTM plans, campaign briefs, promotions |
references/campaigns.md |
| Competitor analysis, audience personas, ICPs, market/positioning audits, segmentation |
references/research.md |
| SEO content briefs, keyword strategy, search intent, on-page optimization |
references/seo.md |
| Email sequences, nurture flows, newsletters, lifecycle/drip campaigns |
references/email-lifecycle.md |
| CRO, A/B testing, funnel optimization, conversion audits |
references/cro.md |
| Metrics, KPIs, attribution, reporting, what to measure and how |
references/measurement.md |
| Release notes, changelogs, feature announcements, battle cards, sales one-pagers, dev-audience marketing |
references/product-marketing.md |
| Character limits, image sizes, or format specs for any channel (ads, email, social, SEO, app stores) |
references/specs.md |
If a task spans several areas (e.g. "launch plan for my app"), read each relevant reference and synthesize.
A launch typically needs campaigns.md + copywriting.md + email-lifecycle.md + measurement.md.
Universal quality bar
Apply these to every deliverable. When reviewing your own draft, check it against this list before
delivering. This is what separates this skill's output from a generic AI response.
Specificity
- Replace every vague adjective ("amazing", "powerful", "seamless", "robust", "innovative") with a
concrete claim, number, or outcome. If you can't, the claim probably isn't true enough to make.
- "Save 3 hours a week on invoicing" beats "Boost your productivity." Numbers, timeframes, and named
outcomes beat abstractions every time.
Reader-first
- Lead with the reader's problem or desire, not the product's features. Features answer "what is it";
benefits answer "what does it do for me"; outcomes answer "what does my life look like after."
- The product is the bridge between where the reader is and where they want to be. Frame it that way.
One message per piece
- Every asset has exactly one job. A landing page that argues three things convinces of none. A campaign
with three core messages has no core message. Pick the one that matters most.
Proof over claims
- Every significant claim needs support: a statistic, a testimonial, a demonstrable mechanism, a
credential, or a specific example. Unsupported superlatives erode trust.
Mechanics
- Active voice. Short sentences. Cut filler ("in order to" → "to"; "it is important to note that" → delete).
- Cut adverbs that prop up weak verbs. Strong verb > weak verb + adverb.
- Read it aloud in your head. If you stumble, the reader will too.
- Match reading level to audience: B2C consumer copy should read at roughly grade 6–8; technical B2B can
go higher but still rewards clarity.
Earn the next line
- The only job of the headline is to get the subhead read. The only job of the first line of an email is
to get the second line read. Momentum is everything in copy.
Honesty
- No fabricated statistics, fake testimonials, or invented credentials. If proof doesn't exist, don't
invent it — but still write the full deliverable, dropping in clearly-marked placeholders where the
proof goes (e.g.
[TESTIMONIAL: specific customer result], [STAT: cite source]) and a one-line note
telling the user to supply the real thing. Refusing to fabricate never means refusing to write — produce
the asset with placeholders, not a lecture. Marketing that overpromises destroys trust and, in many
jurisdictions, breaks advertising law.
Output format conventions
- Copy deliverables: write the finished copy. If producing for a specific medium, format it the way it
will actually appear (subject line + preview text + body for email; headline + subhead + CTA for a hero
section). Label sections so the user can map them to where they go.
- Strategy deliverables: produce a structured document the user can act on immediately — clear headings,
tables where they aid scanning, and concrete next steps. Avoid walls of prose.
- Variants: for high-leverage single elements (subject lines, headlines, primary CTAs, taglines),
offer 3 distinct options that take genuinely different angles — not three rewordings of the same idea.
Label each with the angle it takes (e.g. "Curiosity", "Direct benefit", "Social proof").
- Assumptions: when you've inferred anything load-bearing, state it in one line at the top:
"Assuming [X]; adjust if wrong."
A note on judgment
The frameworks in the reference files are scaffolding, not law. PAS, AIDA, the funnel, content ratios —
these are reliable defaults that prevent common failures, but a skilled marketer breaks them deliberately
when the situation calls for it. Use the frameworks to avoid generic output and obvious mistakes; use
judgment to know when a brand, audience, or moment warrants something different. When you do deviate,
deviate on purpose and be able to say why.
Source: inerrata/brief — distributed by TomeVault.
1---2name: inerrata-brief-marketing3description: Marketing Skill4---56# Marketing Skill78A rigorous, end-to-end marketing skill. It does two things well: produces sharp, ready-to-use9**deliverables** (copy, briefs, plans) and applies disciplined **strategy frameworks** so the output is10grounded rather than generic. The defining principle of this skill is that good marketing is specific,11evidence-led, and built around the reader — not the brand.1213This file is the orchestration layer. It tells you how to approach any marketing task and routes you to14the right deep-dive reference. Read the relevant reference file(s) in `references/` before producing a15deliverable in that area — they contain the detailed frameworks, checklists, formulas, and quality bars16that make the difference between competent and excellent output.1718---1920## How to use this skill2122**Step 0 — Check for a brand profile.** If the project contains a `brand.md` (project root, or next to23this skill), read it before anything else. It is the user's standing brief — company, audience, voice24and tone rules, and proof on file (real stats, testimonials, case studies). Treat its contents as ground25truth for the five brief elements below: don't re-ask what it already answers, draw proof from its26"proof on file" section instead of using placeholders, and follow its voice rules in every deliverable.27Anything the user says in-session overrides it.2829If there is no `brand.md`, proceed normally — but watch for the moment to start one. **Whenever the user30volunteers durable brand facts in-session — their audience, voice or tone rules, a real stat or31testimonial, a positioning or differentiator — deliver what they asked for first, then end your response32by offering to save those facts as a `brand.md`** so they don't have to repeat them next session. This is33not optional politeness; a user who just handed you their voice rules and a sourced stat should always be34offered the profile. The same applies when you find yourself asking scoping questions they've plainly35answered before. Two ways to draft it: (a) fill the template sections (company, audience, voice & tone,36proof on file, standing constraints) from what you've learned in-session, or (b) if you have a web-fetch37tool and the user has a live site, offer to fetch their homepage and draft `brand.md` from it. Either way,38show the draft and let the user correct it before saving — it's their standing brief, not yours.3940**Step 0.5 — Ground in product truth when it's at hand.** When you're working inside the product's own41repository, or have tools that can see the real thing, use them before guessing. Skim the README, docs,42or landing-page source for what the product actually does, and prefer real feature names, limits, and43numbers over invented ones. The same goes for research tasks: if you have web access, read a44competitor's actual site rather than reasoning about it from memory. Real proof you found beats a45placeholder; a placeholder beats an invention.4647**Step 1 — Establish the brief before writing.** Marketing output is only as good as its inputs. Before48producing anything, make sure you know (or have reasonably inferred and flagged) these five things. This49is the single most important habit in this skill.50511. **Audience** — who specifically is this for? (role, situation, what they believe right now)522. **Goal** — what one action should this drive? (click, sign-up, purchase, reply, share)533. **Offer/product** — what is being marketed, and what's the single most important thing about it?544. **Proof** — what evidence supports the claims? (metrics, testimonials, mechanism, credentials)555. **Constraint** — channel, length, tone, brand rules, or anything that bounds the output.5657If the user hasn't given you these, how you proceed depends on the task. There are two task types where58you must STOP and gather inputs first — do not produce the deliverable on assumptions:5960**Gate A — Single load-bearing strategy statements (positioning statement, value proposition, messaging61hierarchy, brand voice/tone definition).** These are the foundations everything downstream inherits, they62compress to one authoritative artifact, and a plausible-looking guess is worse than no answer because it63reads as fact. ONLY these four hard-stop. Ask 2–3 sharp questions covering the most important unknowns64(almost always: who exactly is this for, what's the single most important differentiator, and who/what is65the main alternative) before writing. Do not output a positioning statement built on guessed inputs.6667Everything else that *feels* strategic — ICPs/personas, content calendars, campaign briefs, launch/GTM68plans — is **deliver-first**, not a gate. These are multi-part working documents, not a single69load-bearing sentence: a reader skims an assumption-tagged draft and corrects it in seconds, which is far70more useful than a wall of questions. See the deliver-first rules below; do not hard-stop on them.7172**Gate B — Audits and "improve my X" tasks (audit my landing page, why isn't my email converting, review73my copy, make this better).** You cannot meaningfully audit an asset you cannot see — but asking is the74*last* resort, not the first. If the user gave a URL and you have a web-fetch or browser tool, fetch the75page yourself and audit the live asset. If the asset plausibly lives in the current project (a landing76page in the repo, an email template, README copy), look for it before asking. Only when you cannot see77the asset by any means do you stop and ask the user to share it (paste the copy, share the URL, or upload78a screenshot) plus the goal and audience. If they can't share it, say what you'd need and offer a generic79checklist instead — but make clear a real audit requires seeing the real thing. Do not invent the80contents of the asset and audit your own invention.8182For everything else, scale to stakes — and bias hard toward producing something useful rather than83withholding it. The default is **deliver-first**: state your load-bearing assumptions in one line at the84top, build the real deliverable on them, then optionally append 1–2 sharpening questions. Asking instead85of delivering is the failure mode, not diligence.86- **Big working documents** (a campaign concept, a content strategy/calendar, a launch or GTM plan, an87 ICP or persona): still deliver-first. Open with a one-line assumptions block naming the audience, goal,88 and any other inputs you inferred ("Assuming [audience], goal = [X]; adjust if wrong"), then produce the89 full structured document — the calendar with all its fields, the phased pre/launch/post plan with its90 asset checklist, the ICP with firmographics/pains/triggers. For an ICP or persona, explicitly mark it91 as a **hypothesis pending real customer evidence**, not asserted fact. You may add 2–3 sharpening92 questions *after* the draft, but never withhold the document behind them.93- **A concrete copy deliverable** (a homepage hero, an ad, a landing-page section, a handful of94 subject lines): lead with the copy. Even when the audience or angle is unstated, pick the single95 most likely one, name it in a one-line assumption at the top ("Assuming [X]; adjust if wrong"), and96 write the deliverable anyway. A concrete draft built on a named assumption is far more useful than a97 list of questions: the reader corrects a wrong assumption in seconds, and most of the copy still98 holds. For these requests, **asking first is the failure mode, not diligence** — produce the draft,99 then you may add 1–2 optional sharpening questions *after* it. This is the one place the "never guess100 the audience" rule below bends: stating a guess out loud and building on it is exactly what we want;101 only a *silent, unstated* guess is forbidden.102103Note the difference from Gate A above: defining the *positioning statement, value prop, voice, or104messaging hierarchy* is a single load-bearing artifact and still gets gated, because everything downstream105inherits its flaws. But writing the *copy* that expresses an already-implied position — or building a106*working document* like a calendar, launch plan, or ICP — is a deliverable: lead with the draft and flag107your assumptions.108109Never silently guess on the audience or the goal — those two are load-bearing in every task. Stating110an assumption out loud is fine; hiding one is not.111112**What a good brief-first ask looks like** (keep it to 2–3 questions, make them sharp, don't interrogate):113114> *Before I write this positioning statement, three quick things so it's sharp rather than generic:*115> 1. *Who exactly is this for — what's the narrowest core audience? (e.g. "agencies of 10–50," not "businesses")*116> 2. *What's the one thing you do that the main alternatives don't?*117> 3. *Who or what are you really competing against — a rival tool, a spreadsheet, or just doing nothing?*118119Then write the deliverable using their answers. If they decline to answer, fall back to stated assumptions120and flag that sharpening the inputs would improve the result.121122**Step 2 — Route to the right reference.** Match the task to the table below, read that reference file,123then produce the deliverable following its frameworks.124125**Step 3 — Apply the universal quality bar (below) to everything**, regardless of task.126127**Step 4 — Deliver ready-to-use output, then optionally annotate.** Write the actual copy or build the128actual plan. Don't hand back a description of what could be written. After the deliverable, you may add a129short "why this works" note or offer variants, but the deliverable comes first.130131---132133## Routing table134135| If the task involves... | Read this reference |136|---|---|137| Ads, emails, landing pages, homepages, CTAs, taglines, product/sales copy, social posts, any writing | `references/copywriting.md` |138| Brand voice, tone, messaging hierarchy, value prop, positioning, boilerplate, naming | `references/brand-messaging.md` |139| Content calendars, editorial plans, content pillars, blog/social strategy, repurposing | `references/content-strategy.md` |140| Campaign concepts, product launches, GTM plans, campaign briefs, promotions | `references/campaigns.md` |141| Competitor analysis, audience personas, ICPs, market/positioning audits, segmentation | `references/research.md` |142| SEO content briefs, keyword strategy, search intent, on-page optimization | `references/seo.md` |143| Email sequences, nurture flows, newsletters, lifecycle/drip campaigns | `references/email-lifecycle.md` |144| CRO, A/B testing, funnel optimization, conversion audits | `references/cro.md` |145| Metrics, KPIs, attribution, reporting, what to measure and how | `references/measurement.md` |146| Release notes, changelogs, feature announcements, battle cards, sales one-pagers, dev-audience marketing | `references/product-marketing.md` |147| Character limits, image sizes, or format specs for any channel (ads, email, social, SEO, app stores) | `references/specs.md` |148149If a task spans several areas (e.g. "launch plan for my app"), read each relevant reference and synthesize.150A launch typically needs `campaigns.md` + `copywriting.md` + `email-lifecycle.md` + `measurement.md`.151152---153154## Universal quality bar155156Apply these to every deliverable. When reviewing your own draft, check it against this list before157delivering. This is what separates this skill's output from a generic AI response.158159**Specificity**160- Replace every vague adjective ("amazing", "powerful", "seamless", "robust", "innovative") with a161 concrete claim, number, or outcome. If you can't, the claim probably isn't true enough to make.162- "Save 3 hours a week on invoicing" beats "Boost your productivity." Numbers, timeframes, and named163 outcomes beat abstractions every time.164165**Reader-first**166- Lead with the reader's problem or desire, not the product's features. Features answer "what is it";167 benefits answer "what does it do for me"; outcomes answer "what does my life look like after."168- The product is the bridge between where the reader is and where they want to be. Frame it that way.169170**One message per piece**171- Every asset has exactly one job. A landing page that argues three things convinces of none. A campaign172 with three core messages has no core message. Pick the one that matters most.173174**Proof over claims**175- Every significant claim needs support: a statistic, a testimonial, a demonstrable mechanism, a176 credential, or a specific example. Unsupported superlatives erode trust.177178**Mechanics**179- Active voice. Short sentences. Cut filler ("in order to" → "to"; "it is important to note that" → delete).180- Cut adverbs that prop up weak verbs. Strong verb > weak verb + adverb.181- Read it aloud in your head. If you stumble, the reader will too.182- Match reading level to audience: B2C consumer copy should read at roughly grade 6–8; technical B2B can183 go higher but still rewards clarity.184185**Earn the next line**186- The only job of the headline is to get the subhead read. The only job of the first line of an email is187 to get the second line read. Momentum is everything in copy.188189**Honesty**190- No fabricated statistics, fake testimonials, or invented credentials. If proof doesn't exist, don't191 invent it — but **still write the full deliverable**, dropping in clearly-marked placeholders where the192 proof goes (e.g. `[TESTIMONIAL: specific customer result]`, `[STAT: cite source]`) and a one-line note193 telling the user to supply the real thing. Refusing to fabricate never means refusing to write — produce194 the asset with placeholders, not a lecture. Marketing that overpromises destroys trust and, in many195 jurisdictions, breaks advertising law.196197---198199## Output format conventions200201- **Copy deliverables**: write the finished copy. If producing for a specific medium, format it the way it202 will actually appear (subject line + preview text + body for email; headline + subhead + CTA for a hero203 section). Label sections so the user can map them to where they go.204- **Strategy deliverables**: produce a structured document the user can act on immediately — clear headings,205 tables where they aid scanning, and concrete next steps. Avoid walls of prose.206- **Variants**: for high-leverage single elements (subject lines, headlines, primary CTAs, taglines),207 offer 3 distinct options that take genuinely different angles — not three rewordings of the same idea.208 Label each with the angle it takes (e.g. "Curiosity", "Direct benefit", "Social proof").209- **Assumptions**: when you've inferred anything load-bearing, state it in one line at the top:210 "Assuming [X]; adjust if wrong."211212---213214## A note on judgment215216The frameworks in the reference files are scaffolding, not law. PAS, AIDA, the funnel, content ratios —217these are reliable defaults that prevent common failures, but a skilled marketer breaks them deliberately218when the situation calls for it. Use the frameworks to avoid generic output and obvious mistakes; use219judgment to know when a brand, audience, or moment warrants something different. When you do deviate,220deviate on purpose and be able to say why.221222---223> Source: [inerrata/brief](https://github.com/inerrata/brief) — distributed by [TomeVault](https://tomevault.io).224<!-- tomevault:4.0:skill_md:2026-06-16 -->