Build Brand Strategy
Skill8 starsChanged 5 months agoMITView on GitHub
Turn how a business owner talks about their work into a sharp brand brief — positioning, a promise/tagline, the only-we claim, and content angles — in their own words. Works keylessly day one from the owner's words plus free web research; deepens into the full five-doc strategy when call-transcript evidence is available. Every claim anchored in real evidence — no invented customer quotes.
In this repository101 other files it gives its agents.
- templates/CLAUDE.mdCLAUDE.md
- Add a FieldSkill
- Assemble Content PackSkill
- Assemble PackSkill
- Audit My AutomationsSkill
- Audit My DataSkill
- automate-thisSkill
- Brand My WorkspaceSkill
- Break Down A ChannelSkill
- Build Customer VoiceSkill
- Build DocumentSkill
- Build FormSkill
- Build Knowledge Base From DocsSkill
- Build My ProofSkill
- Build My VoiceSkill
- Build Social StrategySkill
- Build SpreadsheetSkill
- Build Work Order ProcessSkill
- Cash Flow ForecastSkill
- Coach My CallsSkill
- Compare DocumentsSkill
- Connect A ToolSkill
- Delegate This WorkSkill
- Describe A ProductSkill
- Design My ScenesSkill
- Design Nurture SequenceSkill
- draft-replySkill
- Email Me A ReportSkill
- Estimate My BASSkill
- Extract DocumentSkill
- Find My Next MoveSkill
- Five Day ChallengeSkill
- Follow-up RadarSkill
- Form RadarSkill
- Get Found OnlineSkill
- Grill Me On This DecisionSkill
- import-from-anywhereSkill
- lead-triageSkill
- Learn My BusinessSkill
- Lint DocumentSkill
- Lint FormSkill
- Lint Nurture SequenceSkill
- log-this-callSkill
- make-it-happenSkill
- Make My VideoSkill
- Make Product DemoSkill
- Make Social PostSkill
- Make ThumbnailSkill
- missed-call-recoverySkill
- Nurture HealthSkill
- Onboard Team MemberSkill
- Outstanding DocumentsSkill
- Outstanding InvoicesSkill
- Package My VideoSkill
- Plan My AdsSkill
- Plan My ContentSkill
- Plan My RoadmapSkill
- Plan My YouTubeSkill
- Prep For CallSkill
- Price My WorkSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
16 rules. About 0 are common, 13 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈13
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 88
Confirm before trusting research: If a scrape/search turns up a business, check it's actually theirs before leaning on it ("found …
- Distinctive: line 93
Market-gate pre-check (business-method.md §7.0): if the gathered evidence shows a hard fail on real pain or purchasing power for the avatar …
- Distinctive: line 100
Before writing a word of the brief, walk the positioning ladder (business-method.md §14) in strict order.
- Very specific: line 125
Write a single short brief (Markdown is fine.
- Distinctive: line 157
When you've used a phrase straight from them or from a review, that's the point — it should feel like *"that's exactly how I'd put it."*
- Distinctive: line 162
Never invent a customer quote or a testimonial: If you don't have a real quote, anchor in the owner's own words instead.
- Distinctive: line 167
If the brain-dump plus research are too thin to produce something genuinely sharp — you'd be padding or guessing — don't ship a hollow …
- Very specific: line 207
If it doesn't exist and the operator wants this deeper mode, they can run build-customer-voice first — but the keyless first-brand-brief …
- Distinctive: line 214
Read every section. You'll be quoting from §1 (who's on calls), §2 (pain), §3 (jobs to be done), §4 (objections), §5 (competing tools), §6 …
- Distinctive: line 219
Market-gate pre-check (business-method.md §7.0): if the synthesis shows a hard fail on real pain or purchasing power for the primary …
- Very specific: line 226
Default: write into marketing-strategy/<BrandName>/.
- Distinctive: line 232
Write them in this order — each one's evidence is reusable in the next.
- Distinctive: line 423
When done, tell the operator:
- Distinctive: line 450
Never clobber a positioning field that is already there: Read the brand home's positioning file before authoring either mode's brief.
- Distinctive: line 462
The founder's voice is the brand: When in doubt, ask before diverging from copy they've already approved.
- Distinctive: line 470
No padding: If a section has 3 things, write 3 — don't pad to 5.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Build Brand Strategy
You turn how an owner talks about their business into brand strategy that sounds like them — never invented sales copy. Every claim traces back to real evidence: something the owner said, something the market said, or a verbatim customer quote. If a claim has no evidence behind it, it doesn't ship.
The source of truth for shapes + anti-patterns is
knowledge/marketing-strategy-method.md
— read its "Layer 3 — The brand strategy docs" section before authoring the
full five-doc set.
Pick the mode — start with what you have
There are two ways to run this, and the right one depends on what evidence exists right now:
| You have… | Mode | What you produce |
| Just the owner's words (and maybe a website) — the default for a brand-new owner | First-brand-brief (keyless) | A one-page brand brief: positioning paragraph, one-sentence promise/tagline, the only-we claim, 3 content angles |
A customer-voice-synthesis.md built from real call transcripts | Full strategy (the deeper mode) | The five canonical docs (positioning, ICP, voice, value-props, content-pillars), every claim quote-anchored |
Default to the first-brand-brief whenever there is no
customer-voice-synthesis.md. It needs no accounts, no files, and no
prior setup — only the owner's words plus free web research. Do NOT stop
and demand a synthesis; that's the cold-start failure the brief exists to
avoid. The full five-doc strategy is the upgrade you offer once richer
evidence exists — never the price of entry.
Mode A — First-brand-brief (keyless, the day-one default)
This is the instant win for an owner who has just shown up: no CRM, no transcripts, no files — just told you (or typed/pasted) what they do. In a couple of minutes you reflect their business back to them sharper than their current website does, in their own words.
A1 — Gather the evidence (keylessly, three sources)
You are sourcing customer voice — real evidence of how people talk about the problem this business solves and the outcome they want. With no transcripts to mine, pull it from these three keyless sources, in order of what's available:
- The owner's brain-dump / what they tell you. Whatever they said about what they do, who it's for, and what they're known for. This is primary evidence — capture their exact phrasing.
- Keyless web research — use the
firecrawl-scrapeandfirecrawl-searchskills (no API key needed for scrape/search):firecrawl-scrapethe owner's own website if they gave one — pull their services, the words they already use, any testimonials or reviews quoted on the site.firecrawl-searchthe business name to find their reviews, testimonials, and how the market describes the problem they solve (directory listings, review sites, social mentions).- Cap the effort: if research is slow, blocked, or comes back empty, fall back to the brain-dump alone and say so plainly ("couldn't find much about you online, so this is built from what you told me — we can sharpen it as we go"). Never let web research stall the win.
- Anything the owner pastes — testimonials, reviews, a few customer emails, an old "about us" blurb. Treat pasted text as local evidence; quote from it directly.
Confirm before trusting research. If a scrape/search turns up a business, check it's actually theirs before leaning on it ("found [Business] in [suburb] doing [X] — that you?"). A confident wrong fact costs more trust than a missing one.
Market-gate pre-check (business-method.md §7.0): if the gathered evidence shows a hard fail on real pain or purchasing power for the avatar the owner described, flag it as a finding before writing any positioning — most offer problems are avatar problems.
A1.5 — Walk the positioning ladder (internally — this is your thinking order, not five extra questions)
Before writing a word of the brief, walk the positioning ladder (business-method.md §14) in strict order. Answer each rung from the brain-dump plus the research you already gathered — not from new owner interviews:
- List the REAL alternatives — what customers would actually do instead, including "do nothing" and "the brother-in-law". Exclude phantom competitors that never appear in real deals.
- Isolate provable attributes — capabilities or facts those alternatives can't truthfully claim.
- "So what?" twice per attribute until each lands on a customer value; cluster into themes.
- Find who cares most — the segment for whom those themes matter disproportionately. This DERIVES the niche; it isn't picked by taste.
- Name the existing category — for a local shape, usually the search phrase to own.
The A2 brief parts fall out of the rungs: the positioning paragraph is rungs 3-5, the transformation is rungs 3-4 said as one line, the only-we claim is rung 2, and the content angles are rung 3's themes. The point of view is the one part no rung produces — it comes from what the owner already told you they think their industry has wrong.
A2 — Produce the brief, in the owner's own words
Write a single short brief (Markdown is fine; offer to save it to
marketing-strategy/<BrandName>/first-brand-brief.md). Six parts. Parts 2 and 5
carry the literal headings Layer 3 gives them (## The transformation,
## The point of view) so channel skills find them by the same anchor here as in
positioning.md:
- Positioning statement (one paragraph). Who they are, who they serve, and the outcome they deliver — phrased the way the owner and their market actually talk, not in agency-speak. Anchor it in an existing category the market already searches for; category creation is a trap at this scale (business-method.md §14).
- The transformation (one line). A specific audience, the state they
start in, and the state they end in. Same field, same tests as
positioning.md's (marketing-strategy-method.md, Layer 3): a category is not an audience and a direction is not an outcome. - The promise / tagline (one sentence). A single forward-looking line that captures the result. Reach for the owner's own phrasing.
- The only-we claim. Two or three things simultaneously true of this business that competitors can't jointly claim — drawn from what the owner said makes them different and what the research showed the market values.
- The point of view (two labelled lines). The belief the owner stated
about what their industry has wrong, and what that belief argues against.
Same field, same limits as
positioning.md's (marketing-strategy-method.md, Layer 3): quoted from the owner, never written for them, aimed at a belief, a tactic, or an ideology rather than a person. If they never said anything that qualifies, leave it as an open slot and say so; do not supply one. - Three content angles. Three topics/hooks this business could lead with, each tied to a real piece of evidence (something the owner said or something the market said).
Reflect their phrasing back. Lift their exact words and use them. When you've used a phrase straight from them or from a review, that's the point — it should feel like "that's exactly how I'd put it."
Anchor every claim in the gathered evidence. Each part of the brief points to its source — the owner's words, a scraped line, a real review. Never invent a customer quote or a testimonial. If you don't have a real quote, anchor in the owner's own words instead; don't fabricate one.
A4 — Thin-evidence guard
If the brain-dump plus research are too thin to produce something genuinely sharp — you'd be padding or guessing — don't ship a hollow brief. Say so plainly and ask ONE targeted question that would unlock it, then build from the answer. For example:
I've got the shape of it, but to make the positioning land I need one thing: what's the job you'd most love more of your customers to ask for?
A real, sharp brief built from one good answer beats a vague one built from nothing. A hollow win confirms the fear that this was a waste of time.
A5 — Walk the owner through it + offer the deeper mode
Show the brief, point out one or two phrases you lifted straight from them (so they see it's theirs), and flag any open choice you left for them.
Then offer the upgrade — without making it the price of entry:
This is built from your words and what's out there publicly. When you've got real customer conversations recorded, I can mine exactly how your customers talk and turn this into a full brand strategy — voice, ICP, value props, the lot. No rush; the brief stands on its own today.
Mode B — Full strategy from a customer-voice synthesis (the deeper mode)
This is the richer, connected-tier path. It runs when a
customer-voice-synthesis.md exists — normally produced by
build-customer-voice, which mines real call/meeting transcripts (a
TrustPager-connected capability). This mode is the upgrade, never the
default and never required for a new owner. If no synthesis exists, use
Mode A — do not stop and demand one.
Prerequisite
A customer-voice-synthesis.md file (usually under
transcripts/<date>/customer-voice-synthesis.md or in the marketing
strategy folder the operator points to), built by build-customer-voice.
If it doesn't exist and the operator wants this deeper mode, they can run
build-customer-voice first — but the keyless first-brand-brief (Mode A)
is the right starting point in the meantime. Don't fabricate a strategy
from thin air.
Step 1 — Read the synthesis end-to-end
Read every section. You'll be quoting from §1 (who's on calls), §2 (pain), §3 (jobs to be done), §4 (objections), §5 (competing tools), §6 (buying moments), §7 (vocabulary), §9 (top 10 quotes), §10 (industry patterns) throughout the strategy docs.
Market-gate pre-check (business-method.md §7.0): if the synthesis shows a hard fail on real pain or purchasing power for the primary audience, flag it as a finding before writing any positioning — most offer problems are avatar problems.
Step 2 — Confirm output location + brand name
Default: write into marketing-strategy/<BrandName>/. Ask the operator
for the brand name (folder name) and confirm the output path before
writing.
Step 3 — Author the five docs
Write them in this order — each one's evidence is reusable in the next.
3.1 positioning.md
# <Brand> — Positioning
> All claims trace back to verbatim quotes in
> [customer-voice-synthesis.md](Reference_Files/customer-voice-synthesis.md).
## Who we are
<one-paragraph identity statement>
## Who we serve (one-liner)
<single sentence naming the buyer in their own language>
## The transformation
<one line: a specific audience, the state they start in, the state they
end in — the promise below is the end state alone, this adds the audience
and the from-state>
## The pain we solve
| Theme | In their words |
|---|---|
| <pain 1> | <verbatim quote with speaker attribution> |
| <pain 2> | ... |
## The promise (what changes for them)
<the end-state, phrased the way customers articulate it>
## The promise in one sentence (working drafts)
<3-5 candidate taglines, each passes the customer-voice test —
"scale", "AI-native", "enterprise-grade" don't appear>
## The only-we claim
<3 things simultaneously true of our brand + not jointly true of any
named competitor in the synthesis — each passes the only-we rubric
(business-method.md §14): named against real alternatives including
do-nothing, provable in one sentence, an identifiable segment cares
disproportionately, stated in the customer's category language>
## The point of view
**The belief:** <what this business thinks its industry has wrong, in the
owner's own stated words — never authored for them, never a platitude>
**What it argues against:** <a belief, a tactic, or an ideology; never a
feeling, a demographic, a person, or a named vendor>
## Proof
<customer count, industries, founder credibility>
## Geographic + cultural register
<where you operate, the tone that matches>3.2 icp.yaml
audiences:
primary:
name: ""
short_label: ""
one_liner: ""
typical_industries: []
typical_team_size: ""
typical_revenue: ""
typical_age_signal: ""
geography: ""
tech_skill_self_description: ""
primary_pain: ""
primary_job_to_be_done: ""
competing_tools_escaped:
enterprise_crm: []
mid_market: []
aggregator_captivity: []
no_tool_at_all: []
buying_trigger: []
objections_to_handle:
- id: ""
objection: ""
handle: ""
evidence_quote: ""
evidence_quotes:
- speaker: ""
business: ""
quote: ""
source: ""
secondary: []
disqualified:
notes: ""
patterns:
- id: ""
pattern: ""
evidence_quote: ""
source: ""Fill from §1, §4, §5, §6, §8, §10 of the synthesis.
3.3 voice.md
Open with the meta-rule:
Founder's voice IS the brand. Everything in this doc is reference material to help write IN that voice when the founder isn't writing personally. When this doc and the founder disagree, the founder wins — and the doc gets updated to reflect what they actually shipped.
The customer-voice synthesis at customer-voice-synthesis.md is INPUT to the brand voice, not the brand voice itself. Customer phrases are available to reach for when they fit the moment — they are NOT required in every email.
Sections:
- Sender persona + email voice spec — LOCKED (sender, sign-off block, mode, technical send constants).
- Tone — 5 adjectives, each backed by evidence.
- Signature moves — forward-looking subjects, warm human openers, one core idea per paragraph, customer phrases as seasoning.
- Vocabulary AVAILABLE — phrases lifted from §7 of synthesis, in a table with attribution.
- Watch out for (hype register / VC speak / Salesforce-era jargon) — default-avoid registers, framed as defaults not absolute bans.
- Words that are FINE despite over-restriction — explicit list of normal business English the founder uses (e.g. streamline, facilitate growth, operations).
- Mechanical preferences — em-dash style, greeting, sign-off, URLs.
- Canonical examples — at minimum, one approved email from the founder with "why this works" annotation.
- Voice spec change log — dated entries when the operator corrects this doc.
3.4 value-props.yaml
value_props:
- id: ""
claim: "" # the outcome statement
pain_addressed: ""
benefit: ""
day_in_life: "" # one-sentence behavioural change
evidence_pain:
- speaker: ""
business: ""
quote: ""
source: ""
evidence_outcome:
- speaker: ""
quote: ""
source: ""
feature_implementation: ""
proof_artefact: null
anti_claims:
- claim: "" # things we WON'T say
reason: ""
evidence_quotes: []Aim for 5-8 value props. Each one is a separate outcome the customer described wanting. Examples that often appear:
- "Your whole business on one screen"
- "Deal-to-done chained automatically"
- "A database you actually own"
- "The tedious admin disappears"
- "Never miss a lead"
- "Customise in plain English"
- "Relationship marketing that runs itself"
3.5 content-pillars.yaml
pillars:
- id: ""
name: ""
pain_addressed: ""
default_channel: []
cadence: ""
example_topics: []
customer_quote_anchor:
speaker: ""
quote: ""
source: ""
cross_cutting_threads: []1:1 with value props is the natural mapping — each prop becomes a pillar.
Step 4 — Walk the operator through it
When done, tell the operator:
- What you wrote, and where
- 3 surprising findings — places where the synthesis contradicts current brand language (e.g. the audience recoils from "AI" framing the website leads with)
- 2-3 open decisions surfaced inside the docs (TBD slots, working drafts) for them to choose between
End with: "Want me to start drafting a nurture sequence from this?
That's the design-nurture-sequence skill."
Hard rules (both modes)
- Every claim is anchored in real evidence. In Mode B that means a verbatim quote from the synthesis. In Mode A it means the owner's own words, a line scraped from their site, or a real review. If a claim has no evidence behind it, it doesn't go in.
- Never invent customer quotes or testimonials. A fabricated quote is worse than no quote. When you lack a real one, anchor in the owner's own words instead.
- The transformation and the point of view are brand-level, not
channel-level. They ship inside the brand brief here (
first-brand-brief.mdin Mode A,positioning.mdin Mode B), besidevoice.md, under the headingsmarketing-strategy-method.mdLayer 3 defines, and channel skills read them from here instead of re-deriving them per channel. - Never clobber a positioning field that is already there. Read the brand home's positioning file before authoring either mode's brief. Where a field already carries an answer (a channel skill may have captured one), carry it forward and show the owner a before/after rather than overwriting it.
- Every only-we claim passes the only-we rubric (business-method.md §14): named against real alternatives including do-nothing, provable in one sentence, an identifiable segment cares disproportionately, stated in the customer's category language. Fail any → back up one rung.
- Content guardrails. Customer-facing copy uses no em dashes, invents
no facts, quotes, or numbers, and names no third-party vendor. Write it in
the owner's brand voice; the framing and marketing psychology are the
owner's choice. The rules are in
knowledge/content-rules.md. - The founder's voice is the brand. When in doubt, ask before diverging from copy they've already approved. Reflect their phrasing back.
- Don't echo customer recoil into our voice. The audience recoiling from "AI" doesn't mean we never say "AI" — it means we don't LEAD with it. AI is the engine, not the headline.
- Surface contradictions, don't smooth them. Where the evidence (a synthesis, or scraped reviews) contradicts the owner's current website copy, flag it as a finding rather than quietly papering over it.
- No padding. If a section has 3 things, write 3 — don't pad to 5.
- TrustPager is never required. Mode A runs with zero accounts and zero files. The transcript-mining synthesis (Mode B) is an optional deeper upgrade, offered after the keyless brief — never the entry price.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

