Files
skills/public/copy-editing.html
zeekayandHanzo Dev 65c3b27843 160 marketing, growth and PM skills, on our own connectors
Four MIT collections ported — growthOS, openclaw-marketing-skills,
Marketing-Skills and pm-skills — as 160 skills, 12 agents and 45
commands, each naming its origin in its own frontmatter so the tree can
be checked against THIRD_PARTY_NOTICES rather than trusted. Sixteen names
appeared in more than one collection and none of the copies were
identical; the longest wins, which lands on the more developed text where
they genuinely diverge.

A fifth collection is deliberately absent. awesome-growth-hacking-skills
carries NO licence, which leaves its author every right by default — and
it is a list of links rather than a collection of skills, so there is
nothing in it to port and no permission to port it with. It is cited as a
directory to read.

THE CONNECTOR SKILLS ARE REWRITTEN, not ported. They arrived installing
vendor SDKs, running OAuth flows of their own, and ending with long-lived
credentials in JSON files under .agents/ and ~/.growthos/ at mode 600.
That is a secret on a disk with no rotation path, protected from other
users and not from the agent — and one auth implementation per skill.
Hanzo holds these connectors in Go, per user, sealed in KMS, so `connect`
is the one home for the flow and the platform skills defer to it by
provider id: google_ads, meta_ads, x. It is reachable as HTTP or as MCP
tools at api.hanzo.ai/v1/mcp — the same routes, typed once in Go, so a
tool and a curl cannot disagree.

Two had nothing real behind them and now say so. There is no
search_console provider, so that skill names what does answer the same
questions (google_analytics, google_bigquery) and states that the remedy
is a provider in hanzoai/cloud rather than a vendor SDK here. And
getxapi-connect was a wrapper around a paid reseller of X's public data
with the vendor's key in an env var; it is `listen` now, on our own x
connector — a skill named after a vendor makes the vendor the capability
and dies with it.

The skills referenced paths that only existed inside the source repo, so
the shared material they read is ported to reference/ and the paths
rewritten. Three skills need the growthOS APPLICATION rather than its
data; per the estate's own split an application belongs in hanzoai/ads,
social, email or sms as a cloud plugin, so those three say what they need
instead of carrying an import that resolves to nothing.

Third-party product names are out of our prose and kept in the notices,
which is where the licence requires them and the only place they belong.
A skill's persona names a role, not somebody else's product.


Co-authored-by: Hanzo Dev <[email protected]>
2026-09-15 01:27:26 -07:00

379 lines
30 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>copy-editing</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/copy-editing.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/copy-editing">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/copy-editing.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>copy-editing</h1><p class="lede">When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions &#x27;edit this copy,&#x27; &#x27;review my copy,&#x27; &#x27;copy feedback,&#x27; &#x27;proofread,&#x27; &#x27;polish this,&#x27; &#x27;make this better,&#x27; &#x27;copy sweep,&#x27; &#x27;tighten this up,&#x27; &#x27;this reads awkwardly,&#x27; &#x27;clean up this text,&#x27; &#x27;too wordy,&#x27; &#x27;sharpen the messaging,&#x27; &#x27;refresh this content,&#x27; &#x27;update this page,&#x27; &#x27;this content is outdated,&#x27; or &#x27;content audit.&#x27; Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.</p><h1>Copy Editing</h1>
<p>You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message.</p>
<h2>Core Philosophy</h2>
<p><strong>Check for product marketing context first:</strong> If <code>.agents/product-marketing.md</code> exists (or <code>.claude/product-marketing.md</code>, or the legacy <code>product-marketing-context.md</code> filename, in older setups), read it before editing. Use brand voice and customer language from that context to guide your edits.</p>
<p>Good copy editing isn&#x27;t about rewriting—it&#x27;s about enhancing. Each pass focuses on one dimension, catching issues that get missed when you try to fix everything at once.</p>
<p><strong>Key principles:</strong></p>
<ul><li>Don&#x27;t change the core message; focus on enhancing it</li><li>Multiple focused passes beat one unfocused review</li><li>Each edit should have a clear reason</li><li>Preserve the author&#x27;s voice while improving clarity</li></ul>
<hr>
<h2>The Seven Sweeps Framework</h2>
<p>Edit copy through seven sequential passes, each focusing on one dimension. After each sweep, loop back to check previous sweeps aren&#x27;t compromised.</p>
<h3>Sweep 1: Clarity</h3>
<p><strong>Focus:</strong> Can the reader understand what you&#x27;re saying?</p>
<p><strong>What to check:</strong></p>
<ul><li>Confusing sentence structures</li><li>Unclear pronoun references</li><li>Jargon or insider language</li><li>Ambiguous statements</li><li>Missing context</li></ul>
<p><strong>Common clarity killers:</strong></p>
<ul><li>Sentences trying to say too much</li><li>Abstract language instead of concrete</li><li>Assuming reader knowledge they don&#x27;t have</li><li>Burying the point in qualifications</li></ul>
<p><strong>Process:</strong></p>
<ol><li>Read through quickly, highlighting unclear parts</li><li>Don&#x27;t correct yet—just note problem areas</li><li>After marking issues, recommend specific edits</li><li>Verify edits maintain the original intent</li></ol>
<p><strong>After this sweep:</strong> Confirm the &quot;Rule of One&quot; (one main idea per section) and &quot;You Rule&quot; (copy speaks to the reader) are intact.</p>
<hr>
<h3>Sweep 2: Voice and Tone</h3>
<p><strong>Focus:</strong> Is the copy consistent in how it sounds?</p>
<p><strong>What to check:</strong></p>
<ul><li>Shifts between formal and casual</li><li>Inconsistent brand personality</li><li>Mood changes that feel jarring</li><li>Word choices that don&#x27;t match the brand</li></ul>
<p><strong>Common voice issues:</strong></p>
<ul><li>Starting casual, becoming corporate</li><li>Mixing &quot;we&quot; and &quot;the company&quot; references</li><li>Humor in some places, serious in others (unintentionally)</li><li>Technical language appearing randomly</li></ul>
<p><strong>Process:</strong></p>
<ol><li>Read aloud to hear inconsistencies</li><li>Mark where tone shifts unexpectedly</li><li>Recommend edits that smooth transitions</li><li>Ensure personality remains throughout</li></ol>
<p><strong>After this sweep:</strong> Return to Clarity Sweep to ensure voice edits didn&#x27;t introduce confusion.</p>
<hr>
<h3>Sweep 3: So What</h3>
<p><strong>Focus:</strong> Does every claim answer &quot;why should I care?&quot;</p>
<p><strong>What to check:</strong></p>
<ul><li>Features without benefits</li><li>Claims without consequences</li><li>Statements that don&#x27;t connect to reader&#x27;s life</li><li>Missing &quot;which means...&quot; bridges</li></ul>
<p><strong>The So What test:</strong> For every statement, ask &quot;Okay, so what?&quot; If the copy doesn&#x27;t answer that question with a deeper benefit, it needs work.</p>
<p>❌ &quot;Our platform uses AI-powered analytics&quot; <em>So what?</em> ✅ &quot;Our AI-powered analytics surface insights you&#x27;d miss manually—so you can make better decisions in half the time&quot;</p>
<p><strong>Common So What failures:</strong></p>
<ul><li>Feature lists without benefit connections</li><li>Impressive-sounding claims that don&#x27;t land</li><li>Technical capabilities without outcomes</li><li>Company achievements that don&#x27;t help the reader</li></ul>
<p><strong>Process:</strong></p>
<ol><li>Read each claim and literally ask &quot;so what?&quot;</li><li>Highlight claims missing the answer</li><li>Add the benefit bridge or deeper meaning</li><li>Ensure benefits connect to real reader desires</li></ol>
<p><strong>After this sweep:</strong> Return to Voice and Tone, then Clarity.</p>
<hr>
<h3>Sweep 4: Prove It</h3>
<p><strong>Focus:</strong> Is every claim supported with evidence?</p>
<p><strong>What to check:</strong></p>
<ul><li>Unsubstantiated claims</li><li>Missing social proof</li><li>Assertions without backup</li><li>&quot;Best&quot; or &quot;leading&quot; without evidence</li></ul>
<p><strong>Types of proof to look for:</strong></p>
<ul><li>Testimonials with names and specifics</li><li>Case study references</li><li>Statistics and data</li><li>Third-party validation</li><li>Guarantees and risk reversals</li><li>Customer logos</li><li>Review scores</li></ul>
<p><strong>Common proof gaps:</strong></p>
<ul><li>&quot;Trusted by thousands&quot; (which thousands?)</li><li>&quot;Industry-leading&quot; (according to whom?)</li><li>&quot;Customers love us&quot; (show them saying it)</li><li>Results claims without specifics</li></ul>
<p><strong>Process:</strong></p>
<ol><li>Identify every claim that needs proof</li><li>Check if proof exists nearby</li><li>Flag unsupported assertions</li><li>Recommend adding proof or softening claims</li></ol>
<p><strong>After this sweep:</strong> Return to So What, Voice and Tone, then Clarity.</p>
<hr>
<h3>Sweep 5: Specificity</h3>
<p><strong>Focus:</strong> Is the copy concrete enough to be compelling?</p>
<p><strong>What to check:</strong></p>
<ul><li>Vague language (&quot;improve,&quot; &quot;enhance,&quot; &quot;optimize&quot;)</li><li>Generic statements that could apply to anyone</li><li>Round numbers that feel made up</li><li>Missing details that would make it real</li></ul>
<p><strong>Specificity upgrades:</strong></p>
<p>| Vague | Specific | |-------|----------| | Save time | Save 4 hours every week | | Many customers | 2,847 teams | | Fast results | Results in 14 days | | Improve your workflow | Cut your reporting time in half | | Great support | Response within 2 hours |</p>
<p><strong>Common specificity issues:</strong></p>
<ul><li>Adjectives doing the work nouns should do</li><li>Benefits without quantification</li><li>Outcomes without timeframes</li><li>Claims without concrete examples</li></ul>
<p><strong>Process:</strong></p>
<ol><li>Highlight vague words and phrases</li><li>Ask &quot;Can this be more specific?&quot;</li><li>Add numbers, timeframes, or examples</li><li>Remove content that can&#x27;t be made specific (it&#x27;s probably filler)</li></ol>
<p><strong>After this sweep:</strong> Return to Prove It, So What, Voice and Tone, then Clarity.</p>
<hr>
<h3>Sweep 6: Heightened Emotion</h3>
<p><strong>Focus:</strong> Does the copy make the reader feel something?</p>
<p><strong>What to check:</strong></p>
<ul><li>Flat, informational language</li><li>Missing emotional triggers</li><li>Pain points mentioned but not felt</li><li>Aspirations stated but not evoked</li></ul>
<p><strong>Emotional dimensions to consider:</strong></p>
<ul><li>Pain of the current state</li><li>Frustration with alternatives</li><li>Fear of missing out</li><li>Desire for transformation</li><li>Pride in making smart choices</li><li>Relief from solving the problem</li></ul>
<p><strong>Techniques for heightening emotion:</strong></p>
<ul><li>Paint the &quot;before&quot; state vividly</li><li>Use sensory language</li><li>Tell micro-stories</li><li>Reference shared experiences</li><li>Ask questions that prompt reflection</li></ul>
<p><strong>Process:</strong></p>
<ol><li>Read for emotional impact—does it move you?</li><li>Identify flat sections that should resonate</li><li>Add emotional texture while staying authentic</li><li>Ensure emotion serves the message (not manipulation)</li></ol>
<p><strong>After this sweep:</strong> Return to Specificity, Prove It, So What, Voice and Tone, then Clarity.</p>
<hr>
<h3>Sweep 7: Zero Risk</h3>
<p><strong>Focus:</strong> Have we removed every barrier to action?</p>
<p><strong>What to check:</strong></p>
<ul><li>Friction near CTAs</li><li>Unanswered objections</li><li>Missing trust signals</li><li>Unclear next steps</li><li>Hidden costs or surprises</li></ul>
<p><strong>Risk reducers to look for:</strong></p>
<ul><li>Money-back guarantees</li><li>Free trials</li><li>&quot;No credit card required&quot;</li><li>&quot;Cancel anytime&quot;</li><li>Social proof near CTA</li><li>Clear expectations of what happens next</li><li>Privacy assurances</li></ul>
<p><strong>Common risk issues:</strong></p>
<ul><li>CTA asks for commitment without earning trust</li><li>Objections raised but not addressed</li><li>Fine print that creates doubt</li><li>Vague &quot;Contact us&quot; instead of clear next step</li></ul>
<p><strong>Process:</strong></p>
<ol><li>Focus on sections near CTAs</li><li>List every reason someone might hesitate</li><li>Check if the copy addresses each concern</li><li>Add risk reversals or trust signals as needed</li></ol>
<p><strong>After this sweep:</strong> Return through all previous sweeps one final time: Heightened Emotion, Specificity, Prove It, So What, Voice and Tone, Clarity.</p>
<hr>
<h2>Expert Panel Scoring</h2>
<p>Use this after completing the Seven Sweeps for an additional quality gate. For high-stakes copy (landing pages, launch emails, sales pages), a multi-persona expert review catches issues that a single perspective misses.</p>
<h3>How It Works</h3>
<ol><li><strong>Assemble 3-5 expert personas</strong> relevant to the copy type</li><li><strong>Each persona scores the copy 1-10</strong> on their area of expertise</li><li><strong>Collect specific critiques</strong> — not just scores, but what to fix</li><li><strong>Revise based on feedback</strong> — address the lowest-scoring areas first</li><li><strong>Re-score after revisions</strong> — iterate until all personas score 7+, with an average of 8+ across the panel</li></ol>
<h3>Recommended Expert Panels</h3>
<p><strong>Landing page copy:</strong></p>
<ul><li>Conversion copywriter (clarity, CTA strength, benefit hierarchy)</li><li>UX writer (scannability, cognitive load, user flow)</li><li>Target customer persona (does this speak to me? do I trust it?)</li><li>Brand strategist (voice consistency, positioning accuracy)</li></ul>
<p><strong>Email sequence:</strong></p>
<ul><li>Email marketing specialist (subject lines, open/click optimization)</li><li>Copywriter (hooks, storytelling, persuasion)</li><li>Spam filter analyst (deliverability red flags, trigger words)</li><li>Target customer persona (relevance, value, unsubscribe risk)</li></ul>
<p><strong>Sales page / long-form:</strong></p>
<ul><li>Direct response copywriter (offer structure, objection handling, urgency)</li><li>Skeptical buyer persona (proof gaps, trust issues, red flags)</li><li>Editor (flow, readability, conciseness)</li><li>SEO specialist (keyword coverage, search intent alignment)</li></ul>
<h3>Scoring Rubric</h3>
<p>| Score | Meaning | |-------|---------| | 9-10 | Publish-ready. No meaningful improvements. | | 7-8 | Strong. Minor tweaks only. | | 5-6 | Functional but has clear gaps. Needs another pass. | | 3-4 | Significant issues. Major revision needed. | | 1-2 | Fundamentally broken. Rethink approach. |</p>
<h3>When to Use</h3>
<ul><li><strong>Always</strong> for launch copy, pricing pages, and high-traffic landing pages</li><li><strong>Recommended</strong> for email sequences, sales pages, and ad copy</li><li><strong>Optional</strong> for blog posts, social content, and internal docs</li><li><strong>Skip</strong> for quick updates, minor edits, and low-stakes content</li></ul>
<hr>
<h2>Quick-Pass Editing Checks</h2>
<p>Use these for faster reviews when a full seven-sweep process isn&#x27;t needed.</p>
<h3>Word-Level Checks</h3>
<p><strong>Cut these words:</strong></p>
<ul><li>Very, really, extremely, incredibly (weak intensifiers)</li><li>Just, actually, basically (filler)</li><li>In order to (use &quot;to&quot;)</li><li>That (often unnecessary)</li><li>Things, stuff (vague)</li></ul>
<p><strong>Replace these:</strong></p>
<p>| Weak | Strong | |------|--------| | Utilize | Use | | Implement | Set up | | Leverage | Use | | Facilitate | Help | | Innovative | New | | Robust | Strong | | Seamless | Smooth | | Cutting-edge | New/Modern |</p>
<p><strong>Watch for:</strong></p>
<ul><li>Adverbs (usually unnecessary)</li><li>Passive voice (switch to active)</li><li>Nominalizations (verb → noun: &quot;make a decision&quot; → &quot;decide&quot;)</li></ul>
<h3>Sentence-Level Checks</h3>
<ul><li>One idea per sentence</li><li>Vary sentence length (mix short and long)</li><li>Front-load important information</li><li>Max 3 conjunctions per sentence</li><li>No more than 25 words (usually)</li></ul>
<h3>Paragraph-Level Checks</h3>
<ul><li>One topic per paragraph</li><li>Short paragraphs (2-4 sentences for web)</li><li>Strong opening sentences</li><li>Logical flow between paragraphs</li><li>White space for scannability</li></ul>
<hr>
<h2>Copy Editing Checklist</h2>
<p>For a final QA pass before delivering edits, work through the full checklist in <a href="references/checklist.md">references/checklist.md</a> — covering all seven sweeps plus pre-start and final-check items.</p>
<hr>
<h2>Common Copy Problems &amp; Fixes</h2>
<h3>Problem: Wall of Features</h3>
<p><strong>Symptom:</strong> List of what the product does without why it matters <strong>Fix:</strong> Add &quot;which means...&quot; after each feature to bridge to benefits</p>
<h3>Problem: Corporate Speak</h3>
<p><strong>Symptom:</strong> &quot;Leverage synergies to optimize outcomes&quot; <strong>Fix:</strong> Ask &quot;How would a human say this?&quot; and use those words</p>
<h3>Problem: Weak Opening</h3>
<p><strong>Symptom:</strong> Starting with company history or vague statements <strong>Fix:</strong> Lead with the reader&#x27;s problem or desired outcome</p>
<h3>Problem: Buried CTA</h3>
<p><strong>Symptom:</strong> The ask comes after too much buildup, or isn&#x27;t clear <strong>Fix:</strong> Make the CTA obvious, early, and repeated</p>
<h3>Problem: No Proof</h3>
<p><strong>Symptom:</strong> &quot;Customers love us&quot; with no evidence <strong>Fix:</strong> Add specific testimonials, numbers, or case references</p>
<h3>Problem: Generic Claims</h3>
<p><strong>Symptom:</strong> &quot;We help businesses grow&quot; <strong>Fix:</strong> Specify who, how, and by how much</p>
<h3>Problem: Mixed Audiences</h3>
<p><strong>Symptom:</strong> Copy tries to speak to everyone, resonates with no one <strong>Fix:</strong> Pick one audience and write directly to them</p>
<h3>Problem: Feature Overload</h3>
<p><strong>Symptom:</strong> Listing every capability, overwhelming the reader <strong>Fix:</strong> Focus on 3-5 key benefits that matter most to the audience</p>
<hr>
<h2>Working with Copy Sweeps</h2>
<p>When editing collaboratively:</p>
<ol><li><strong>Run a sweep and present findings</strong> - Show what you found, why it&#x27;s an issue</li><li><strong>Recommend specific edits</strong> - Don&#x27;t just identify problems; propose solutions</li><li><strong>Request the updated copy</strong> - Let the author make final decisions</li><li><strong>Verify previous sweeps</strong> - After each round of edits, re-check earlier sweeps</li><li><strong>Repeat until clean</strong> - Continue until a full sweep finds no new issues</li></ol>
<p>This iterative process ensures each edit doesn&#x27;t create new problems while respecting the author&#x27;s ownership of the copy.</p>
<hr>
<h2>References</h2>
<ul><li><a href="references/plain-english-alternatives.md">Plain English Alternatives</a>: Replace complex words with simpler alternatives</li><li><a href="references/content-refresh.md">Content Refresh</a>: Full checklist, refresh vs. rewrite matrix, and cadence guide</li><li><a href="references/checklist.md">Copy Editing Checklist</a>: Full QA checklist across all seven sweeps</li></ul>
<hr>
<h2>Content Refresh Editing</h2>
<p>Copy editing isn&#x27;t just for new content. Existing pages decay over time — outdated stats, stale examples, and drifted brand voice. Use the content refresh framework when traffic is declining, data is stale, or the product has changed.</p>
<p><strong>For the full refresh checklist, refresh vs. rewrite decision matrix, and cadence guide</strong>: See <a href="references/content-refresh.md">references/content-refresh.md</a></p>
<hr>
<h2>Task-Specific Questions</h2>
<ol><li>What&#x27;s the goal of this copy? (Awareness, conversion, retention)</li><li>What action should readers take?</li><li>Are there specific concerns or known issues?</li><li>What proof/evidence do you have available?</li><li>Is this new copy or a refresh of existing content?</li></ol>
<hr>
<h2>Related Skills</h2>
<ul><li><strong>copywriting</strong>: For writing new copy from scratch (use this skill to edit after your first draft is complete)</li><li><strong>cro</strong>: For broader page optimization beyond copy</li><li><strong>marketing-psychology</strong>: For understanding why certain edits improve conversion</li><li><strong>ab-testing</strong>: For testing copy variations</li></ul>
<hr>
<h2>When to Use Each Skill</h2>
<p>| Task | Skill to Use | |------|--------------| | Writing new page copy from scratch | copywriting | | Reviewing and improving existing copy | copy-editing (this skill) | | Editing copy you just wrote | copy-editing (this skill) | | Structural or strategic page changes | cro |</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/copy-editing.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>