Communitygithub.com

ianrexexanes/nca-conversion

Use before writing landing/sales page or campaign copy when the audience isn't documented. Produces a Conversion Brief: ICP, personas, ranked problems, voice-of-customer, competitors, differentiation, objections, proof, register. Required before conversion-page-build; optional for conversion-page-audit.

What is nca-conversion?

nca-conversion is a Claude Code agent skill that use before writing landing/sales page or campaign copy when the audience isn't documented. Produces a Conversion Brief: ICP, personas, ranked problems, voice-of-customer, competitors, differentiation, objections, proof, register. Required before conversion-page-build; optional for conversion-page-audit.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ianrexexanes/nca-conversion/tree/main/skills/audience-research

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Audience research

Nothing gets written before this. conversion-page-build refuses to write page copy until a Conversion Brief exists for the client. conversion-page-audit can run without one, but an audit without a brief has no register to check the page against and no ranked problem list to check the argument against — run this first when either is missing.

Research modes

Three modes, in cost order — cheapest first, escalate only when the cheaper one is exhausted. See references/research-modes.md for what each yields, what it costs, and the signal that means it's exhausted and the next mode is warranted.

The brief

Fill assets/conversion-brief-template.md — copy it, don't summarize it. Ten sections: ICP, Personas, Problems (ranked), Voice of customer, Competitive landscape, Differentiation, Objections, Proof available, Register, Open and unconfirmed. Each section in the template states what it establishes and the failure mode of leaving it thin — read those before filling, not after.

Three sections have their own reference file, because getting them wrong is expensive and the reasoning doesn't fit in the template margin:

  • Voice of customer — references/voice-of-customer-mining.md (where the verbatim language actually lives, and how not to paraphrase it into marketing register on the way in).
  • Register — references/register-profiles.md (the five archetypes, their seven dimensions each, and which one this client's buying situation actually signals).
  • Choosing which market or sub-market the ICP even is — references/market-selection.md, and once the market is chosen, references/persona-and-jtbd.md for who inside it the page is written to.

Where the brief goes

By convention in this vault, the file lands at 03 Projects/<Project>/_Research/[C] Conversion Brief — <Client>.md — or your project's research folder if you're not running this inside that setup.

NOT ESTABLISHED

A section you cannot fill is written as NOT ESTABLISHED — <what it would take>, never deleted or left blank. A missing section reads as "not researched"; NOT ESTABLISHED reads as "researched, here's the specific gap" — the one that actually gets closed. See the template's opening note for why this is the rule rather than a suggestion.

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

ianrexexanes/nca-conversion

Use when auditing a live landing page, sales page, pricing page or signup flow for conversion problems — given a URL or a page the user wants reviewed. Produces a ranked report: Fix now, Test don't guess, Not a problem, and Could not check. Also use when the user says 'audit this page', 'why isn't this converting', 'review my landing page', 'CRO audit', 'conversion audit', or pastes a URL and asks what is wrong with it. Works without a Conversion Brief but notes its absence as a limitation.

ianrexexanes/nca-conversion

Use when writing or rewriting copy for a landing page, sales page, homepage, pricing page or opt-in page — after the audience is documented. Walks hero, problem, outcome, solution, mechanism, value stack, proof, objections, guarantee, CTA and FAQ, deciding what each section must accomplish before writing it. Also use when the user says 'write the landing page', 'rewrite this page', 'page copy', 'sales page', 'I need copy for', or hands over an offer and asks for a page. Requires a Conversion Bri

ianrexexanes/nca-conversion

Use when editing or tightening any written marketing copy — page copy, an email, a proposal, an ad, a post. Runs seven passes: Clarity, Voice, So What, Prove It, Specificity, Heightened Emotion, Zero Risk. Also use when the user says 'edit this', 'tighten this copy', 'make this better', 'this reads flat', 'punch this up', or pastes copy and asks for a second look. Optional expert-panel mode.

ianrexexanes/nca-conversion

Use when approved page copy becomes a design spec — before opening a design tool. Covers section type, purpose, content hierarchy, components, responsive intent, visual hierarchy, emphasis, above-the-fold priority, scan path. Also use when the user says 'hand this to design', 'wireframe this', 'Relume brief', 'Figma spec', 'turn this copy into a layout', or has finished copy and asks what's next.

ianrexexanes/nca-conversion

Use when writing hooks, headlines, hero lines, subject lines, ad hooks or CTA copy, including quick one-off variant requests. Crosses eight hook types (outcome, time, effort, callout, contrarian, pain, mechanism, transformation) with register. Also use when the user says 'give me headlines', 'hook ideas', 'hero line', 'subject line', 'CTA copy', 'punchier headline', or asks for variants of a line.

ianrexexanes/nca-conversion

Use when designing, packaging or pricing an offer — before any page exists. Covers Value Equation diagnosis, obstacle mapping, value stack, guarantees and risk reversal, price anchoring, and pitch formats. Also use when the user says 'design an offer', 'package this', 'what should I charge', 'pricing', 'guarantee', 'value stack', 'grand slam offer', or describes a service and asks how to sell it.

Related Skills