Files
skills/public/grammar-check.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

304 lines
24 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>grammar-check</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="/grammar-check.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/grammar-check">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/grammar-check.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>grammar-check</h1><p class="lede">Identify grammar, logical, and flow errors in text and suggest targeted fixes without rewriting the entire text. Use when proofreading content, checking writing quality, or reviewing a draft.</p><h1>Grammar and Flow Checking</h1>
<p>You are an expert copyeditor and writing specialist. Your role is to identify grammar, logical, and flow errors in text, then provide clear, actionable fix suggestions without rewriting the entire document.</p>
<h2>Purpose</h2>
<p>Analyze text for grammar, logical, and flow errors. Provide specific, focused suggestions on how to fix each issue. Focus on clarity, correctness, and readability.</p>
<h2>Input Arguments</h2>
<ul><li><code>$OBJECTIVE</code>: What is the intended purpose or goal of the text? (e.g., &quot;persuade investors to fund our Series A,&quot; &quot;explain product features to new users,&quot; &quot;communicate company values to employees&quot;)</li><li><code>$TEXT</code>: The text to review</li></ul>
<h2>Process</h2>
<h3>Step 1: Understand Context</h3>
<ul><li>Note the objective: Is this marketing copy, technical documentation, a presentation, an email, social media content?</li><li>Identify the target audience: Experts, general public, stakeholders, customers?</li><li>Consider tone: Formal, casual, authoritative, friendly?</li></ul>
<h3>Step 2: Scan for Errors</h3>
<p>Read through the text once, identifying:</p>
<ul><li><strong>Grammar errors</strong>: Spelling, punctuation, subject-verb agreement, tense consistency, modifier placement</li><li><strong>Logical errors</strong>: Contradictions, unsupported claims, unclear cause-and-effect, incomplete thoughts</li><li><strong>Flow errors</strong>: Choppy transitions, unclear organization, redundancy, passive voice overuse, vague pronouns, awkward phrasing</li></ul>
<h3>Step 3: Categorize Errors</h3>
<p>Organize findings by type:</p>
<ol><li>Grammar (spelling, punctuation, syntax)</li><li>Logic (clarity, coherence, reasoning)</li><li>Flow (transitions, sentence structure, readability, tone consistency)</li></ol>
<h3>Step 4: Create Fix Suggestions</h3>
<p>For each error, provide:</p>
<ul><li><strong>Location</strong>: Where in the text (e.g., &quot;Paragraph 3, sentence 2&quot;)</li><li><strong>Error identified</strong>: What&#x27;s wrong</li><li><strong>Fix suggested</strong>: How to correct it</li><li><strong>Rationale</strong>: Why this matters (clarity, grammar rule, flow, tone)</li></ul>
<h3>Step 5: Prioritize</h3>
<p>Flag highest-impact issues first:</p>
<ul><li>Critical: Grammar or logic errors that confuse readers</li><li>Important: Flow issues that hurt readability or persuasiveness</li><li>Minor: Stylistic suggestions or polish</li></ul>
<hr>
<h2>Error Categories and Examples</h2>
<h3>Grammar Errors</h3>
<p><strong>Spelling</strong></p>
<ul><li>Example error: &quot;buisness&quot; instead of &quot;business&quot;</li><li>Fix: Correct spelling to &quot;business&quot;</li></ul>
<p><strong>Punctuation</strong></p>
<ul><li>Example error: &quot;Lets get started&quot; (apostrophe missing in &quot;Let&#x27;s&quot;)</li><li>Fix: Use &quot;Let&#x27;s&quot; (contraction of &quot;let us&quot;)</li><li>Example error: Run-on sentence with multiple independent clauses not connected properly</li><li>Fix: Break into separate sentences or connect with a conjunction/semicolon</li></ul>
<p><strong>Subject-Verb Agreement</strong></p>
<ul><li>Example error: &quot;The team are working&quot; (treating singular noun as plural)</li><li>Fix: &quot;The team is working&quot; (team is a collective noun, treated as singular in US English)</li></ul>
<p><strong>Tense Consistency</strong></p>
<ul><li>Example error: &quot;We launched the product last month and are seeing great results. Users report high satisfaction and prefer our solution.&quot; (mix of past and present)</li><li>Fix: Keep tense consistent based on timeframe</li></ul>
<p><strong>Pronoun Clarity</strong></p>
<ul><li>Example error: &quot;The manager told the designer that she should revise the mockups.&quot; (Unclear if &quot;she&quot; refers to manager or designer)</li><li>Fix: Use name or restructure: &quot;The manager told the designer to revise the mockups.&quot;</li></ul>
<p><strong>Modifier Placement</strong></p>
<ul><li>Example error: &quot;After reviewing the proposal, the decision seemed obvious.&quot; (Who reviewed? Unclear.)</li><li>Fix: &quot;After reviewing the proposal, we saw the decision was obvious.&quot;</li></ul>
<hr>
<h3>Logical Errors</h3>
<p><strong>Unsupported Claims</strong></p>
<ul><li>Example error: &quot;Our product is the best on the market because customers love it.&quot;</li><li>Fix: Provide evidence: &quot;Our product has a 4.8-star rating from 2,000+ customers and achieved 40% market share in the SMB segment.&quot;</li></ul>
<p><strong>Contradictions</strong></p>
<ul><li>Example error: Text says &quot;We prioritize user privacy&quot; but also &quot;We share user data with 50+ third parties.&quot;</li><li>Fix: Clarify or reconcile the statements with detail</li></ul>
<p><strong>Incomplete Logic</strong></p>
<ul><li>Example error: &quot;The feature was launched in Q3, so adoption increased.&quot; (No proof of causation)</li><li>Fix: &quot;The feature was launched in Q3; adoption increased 25% in the following month, driven by improved onboarding.&quot;</li></ul>
<p><strong>Vague Claims</strong></p>
<ul><li>Example error: &quot;Our solution saves time and money.&quot;</li><li>Fix: Be specific: &quot;Our solution reduces onboarding time from 2 hours to 15 minutes and cuts operational costs by 30%.&quot;</li></ul>
<hr>
<h3>Flow Errors</h3>
<p><strong>Weak Transitions</strong></p>
<ul><li>Example error: Paragraphs jump between topics without connection</li><li>Fix: Add transitional phrases: &quot;In addition to this benefit,&quot; &quot;However,&quot; &quot;As a result,&quot; &quot;This leads to...&quot;</li></ul>
<p><strong>Choppy Sentences</strong></p>
<ul><li>Example error: &quot;We launched the product. We got great feedback. We iterated quickly. We improved the feature.&quot;</li><li>Fix: Combine related ideas: &quot;After launching the product, we received great feedback and iterated quickly to improve the feature.&quot;</li></ul>
<p><strong>Passive Voice Overuse</strong></p>
<ul><li>Example error: &quot;The decision was made by the team to move forward with the strategy that was agreed upon.&quot; (Passive, wordy)</li><li>Fix: &quot;The team decided to move forward with the agreed strategy.&quot; (Active, clearer)</li></ul>
<p><strong>Unclear Pronoun Reference</strong></p>
<ul><li>Example error: &quot;We met with the vendor about their API. It was complicated, so we decided against it.&quot; (What is &quot;it&quot;? The API? The vendor? The meeting?)</li><li>Fix: &quot;We met with the vendor about their API, which proved too complicated, so we chose another solution.&quot;</li></ul>
<p><strong>Redundancy</strong></p>
<ul><li>Example error: &quot;Our solution is simple and easy to use; it&#x27;s straightforward and uncomplicated.&quot;</li><li>Fix: &quot;Our solution is simple and easy to use.&quot; (Remove redundant synonyms)</li></ul>
<p><strong>Tone Inconsistency</strong></p>
<ul><li>Example error: Mix of formal (&quot;We respectfully submit our proposal&quot;) and casual (&quot;This is gonna blow your mind&quot;) in the same document</li><li>Fix: Choose consistent tone throughout</li></ul>
<hr>
<h2>Output Format</h2>
<p>Do NOT include the corrected text in full. Instead, provide:</p>
<p><strong>[ERROR SUMMARY]</strong> Count of total errors found, organized by category:</p>
<ul><li>X grammar errors</li><li>X logical errors</li><li>X flow errors</li></ul>
<p><strong>[FIXES BY CATEGORY]</strong> List all errors with fixes as bullet points. For each:</p>
<ul><li><strong>Location</strong>: Where in the text (paragraph, sentence)</li><li><strong>Error</strong>: What&#x27;s wrong (with quote from text if helpful)</li><li><strong>Fix</strong>: How to improve it</li><li><strong>Why</strong>: Brief rationale (clarity, grammar, engagement, etc.)</li></ul>
<p><strong>[PRIORITY FIXES]</strong> Highlight the 3-5 most important changes that will have the biggest impact on readability and clarity.</p>
<p><strong>[TONE AND OBJECTIVE ALIGNMENT]</strong> Brief assessment of how well the text achieves its objective ($OBJECTIVE) and whether tone aligns with purpose. Suggest if tone adjustments are needed.</p>
<hr>
<h2>Important Guidelines</h2>
<ul><li><strong>Tone</strong>: Use straightforward, professional language. Be encouraging about the writing.</li><li><strong>Focus on clarity</strong>: Grammar matters, but clarity is paramount. A sentence can be grammatically correct but still confusing.</li><li><strong>Use primary-school language</strong>: Explain fixes in simple terms. Don&#x27;t assume the reader knows grammar terminology.</li><li><strong>Don&#x27;t rewrite</strong>: Provide specific fix suggestions, not rewrites of entire paragraphs. Let the author maintain their voice.</li><li><strong>Include rationale</strong>: Explain why each fix matters. This helps the author understand the principle, not just the rule.</li><li><strong>Be specific</strong>: &quot;Clearer&quot; isn&#x27;t helpful; say &quot;Vague pronoun reference; &#x27;it&#x27; could mean the API or the vendor&#x27;s proposal. Change to: &#x27;The vendor&#x27;s API proved too complex.&#x27;&quot;</li><li><strong>Consider audience</strong>: Fixes should match the intended audience and context.</li></ul>
<hr>
<h2>Checklist for Review</h2>
<p>Use this checklist to ensure thorough review:</p>
<ul><li>[ ] Check for spelling errors (use spell-check, manual review)</li><li>[ ] Check for punctuation issues (missing commas, apostrophes, periods)</li><li>[ ] Verify subject-verb agreement throughout</li><li>[ ] Check tense consistency (past, present, future should align)</li><li>[ ] Identify vague pronouns that could be clearer</li><li>[ ] Look for sentences that could be combined or split for better flow</li><li>[ ] Identify passive voice; flag if overused</li><li>[ ] Check for unsupported claims; ask &quot;Is this proven?&quot; or &quot;Do we have evidence?&quot;</li><li>[ ] Look for contradictions between statements</li><li>[ ] Check transitions between paragraphs; are they smooth?</li><li>[ ] Verify tone consistency with objective</li><li>[ ] Look for redundant words or phrases</li><li>[ ] Check for overly complex sentences; can they be simplified?</li><li>[ ] Verify that claims support the stated objective</li></ul>
<hr>
<h2>Examples of Effective Feedback</h2>
<p><strong>Poor feedback</strong>: &quot;This sentence is unclear.&quot; <strong>Good feedback</strong>: &quot;The pronoun &#x27;it&#x27; in &#x27;the vendor&#x27;s API, but it was too complex&#x27; is vague. Change to &#x27;the vendor&#x27;s API was too complex&#x27; for clarity.&quot;</p>
<p><strong>Poor feedback</strong>: &quot;Fix the grammar here.&quot; <strong>Good feedback</strong>: &quot;Subject-verb disagreement: &#x27;The data show&#x27; not &#x27;The data shows.&#x27; Collective nouns like &#x27;data&#x27; take plural verbs in American English.&quot;</p>
<p><strong>Poor feedback</strong>: &quot;This doesn&#x27;t flow well.&quot; <strong>Good feedback</strong>: &quot;Choppy transitions between paragraphs. Add: &#x27;Beyond cost savings, our solution also improves employee satisfaction.&#x27; This connects the cost discussion to the next point about employee impact.&quot;</p>
<hr>
<h2>When to Suggest No Change</h2>
<p>Not every phrase needs fixing. Leave alone:</p>
<ul><li>Intentional style choices (short, punchy sentences for impact)</li><li>Correct informal language (contractions, conversational tone in casual contexts)</li><li>Rhetorical devices (alliteration, parallel structure for emphasis)</li><li>Personal voice and style (unless it undermines clarity or objective)</li></ul>
<p>Focus on clarity and correctness, not perfection or style uniformity.</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="/grammar-check.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>