argumentative-essay-editor

name

argumentative-essay-editor

description

Strengthen argumentative essays by steelmanning the opposition, tightening the thesis spine, assigning citations clear jobs, moving supporting detail into notes, and checking the rendered reading experience. Use when editing opinion essays, public arguments, policy critiques, strategic essays, or bilingual essay drafts — or any narrative, reflective, or explanatory essay whose thesis a skeptical reader could push back on — where structure, evidence, and reader objections matter.

Argumentative Essay Editor

Use this skill when the user wants to sharpen an essay's argument rather than merely line-edit prose. The goal is to make the essay harder to dismiss by hostile but serious readers. "Argument" is broad here: any essay that asks the reader to accept a thesis is making one — a policy critique, a strategic memo, or a personal narrative carrying a lesson — whether or not it names an opponent.

Core Principles

Make The Opponent Harder To Beat

"Opponent" is broader than a named adversary. Most essays are not rebuttals of a specific party. In a narrative, a reflection, or an explainer, the opponent is the strongest objection a skeptical reader would raise, or the conventional story the essay pushes against. Find that objection first and state it in the reader's own words; the rest of this skill then applies unchanged. The most common failure is hunting for an "opposing view" when the real opponent is the obvious counterargument the essay never answers — the rebuttal the reader is already forming.

Do not attack the most convenient version of the opposing view. First identify the opponent's strongest actual premise, preferably in language they would recognize. Then attack that. A credible essay makes the reader feel the author has understood the other side at full strength.

Name Your Framing

If the essay uses a phrase, metaphor, or accusation that the opponent did not literally use, say so. Then identify the real underlying premise being attacked. This avoids the "they never said that" objection and keeps the argument honest.

Use Notes As Evidence, Not Self-Commentary

Notes should help readers who will not click the source. Good notes provide direct quotes, factual context, terminology distinctions, source-specific details, or compact evidence. They should not sound like private editorial caveats, apologies, or second thoughts.

Concede The Strongest Case

A strong essay can grant the parts of the opposing view that are true or plausible. The point is not to win every factual skirmish. The point is to show that after granting the opponent's best evidence, the essay's central conclusion still holds.

Concede in one breath. Steelmanning and conceding are the most common source of bloat — the moment you grant the other side, the prose wants to keep explaining itself. A concession is the shortest statement that grants the point and redraws the line: concede, reframe, state the rule. If it runs past a few sentences, it has become an essay inside the essay. Cut it back.

Separate Concession From Surrender

Concession does not mean accepting the opponent's conclusion. Locate the exact step where the opponent moves from a plausible observation to an unsupported conclusion.

Use this pattern:

1. Concede the plausible mechanism or fact.
2. Challenge the conclusion drawn from it.
3. Show the missing step between "this could happen" and "therefore our strategy works."

Show Incentive Chains

Avoid brittle causal claims like "X caused Y" unless the evidence is strong. Often the better argument is about incentives: X made Y more urgent, more rational, more likely, or more strategically necessary. Incentive-chain arguments are usually more defensible than monocausal claims.

Make Citations Perform Jobs

Every citation should have a purpose. It can establish an event, quote an opponent's claim, document public reaction, support a trend, show a benchmark, or preserve a primary source. If a citation does not change the reader's confidence in a sentence, remove it or replace it.

Make every claim traceable, and verify it at the source. A citation's job is unfinished if the words it supposedly anchors are not visible to the reader: when the essay says a source "all but said X," the phrase being paraphrased must appear somewhere checkable — quoted in the text, shown in a screenshot, or carried in a note. And confirm quotes, numbers, and specifics against the primary artifact itself, not a search summary or a secondary write-up; a note that asserts an equity percentage, a date, or who said what to whom must trace to the original. If the author cannot find the source of their own claim, this check has already failed.

Keep Main Text On The Spine

The main essay should carry the thesis, opposition, turn, and conclusion. Supporting texture belongs in notes. Background, caveats, source details, and secondary examples should not interrupt the argument unless they are load-bearing.

Avoid Self-Defeating Caveats

Precision is good. Timidity is not. A caveat should clarify the claim, not drain the sentence of force. If a sentence can be asserted cleanly, assert it cleanly.

Render As A Reader

After editing source text, read the rendered page when possible. Notes, references, embeds, paragraph breaks, and punctuation often behave differently in the browser than in the source file. The essay should feel coherent on the page, not just valid in the editor.

Chinese And Bilingual Essay Polish

Use this section when editing a Chinese version of an argumentative essay, or when syncing an English essay and a Chinese essay.

Mirror Meaning, Not Phrasing

Two instincts collide when syncing versions: mirror structural changes across versions, and write Chinese as Chinese. Resolve them this way — mirror the meaning and the structure across languages; let the surface phrasing diverge. Chinese that reads nothing like the English sentence is good. The two versions making different claims is drift, and drift needs a decision, not a silent edit. A line that merely rephrases is fine; a line that drops a hedge the other version keeps, changes a number, or asserts something the other version does not, is a divergence to flag and resolve.

Write Chinese As Chinese, Not Translated English

Prefer natural Chinese argumentation over literal translation. Watch for English skeletons that produce stiff Chinese, such as:

• "clean causality" -> use "直接证明因果" or "证明某一次切断直接导致某一个结果."
• "change incentives" -> use "改变对方的决策" or describe the concrete decision.
• "stronger case" -> use "更容易成立的辩护" when the claim is narrower, not "更强的版本."
• "steelman" -> use "强版本的论证" for an argument, or rewrite around the actual stance.
• "roadmap item" / "backlog item" -> use "可以继续推迟的内部项目" when that is the real meaning.

If a sentence feels like it was translated from English, rewrite the relationship in Chinese first, then restore any necessary technical term.

Product And AI Translation Conventions

Use stable Chinese terms in AI/product essays unless the local passage clearly needs a different register:

• "agent" -> "智能体"; "coding agent" -> "编程智能体."
• "coplayer" -> "陪玩"; "coworker" -> "同事" when the product metaphor is a collaborator, not an employee title.
• Product names stay in English: "Shortcut", "Cursor", "Claude Code", "OpenClaw."
• "line count" -> "代码行数"; "LOC" in a measurement -> "行代码."
• "viral moment" -> "出圈时刻"; avoid leaving "viral moment" in Chinese body prose.
• "retention" -> "留存"; "daily actives" -> "日活"; "signups" -> "注册数"; "vanity counts" -> "虚荣指标."
• "people coming back" -> "持续使用" or "留存"; avoid the literal "回来" unless the physical return is the point.
• "alpha" / "beta" -> "内测" / "早期公开测试" when they mean early testing, not formal release labels.
• "affordance" -> "可供性"; "functional affordance" -> "功能可供性."
• "ship" -> "发布" or "推出"; avoid "发货" unless the slang is intentional.
• "demo" as a verb -> "演示" or "展示"; do not leave "demo 出" in polished Chinese.
• "market verdict" / "face the verdict" -> "市场检验" or "面对现实"; avoid "裁决" unless the judicial metaphor is intentional.
• "commitment to the product" is often better as "真心想做成一个产品" than a literal "承诺."
• "build" / "building" in product essays often means "做产品", "创造产品", or "产品建设"; do not default to "构建" everywhere. "builder" is usually "创造产品的人" or "做产品的人", not "构建者."
• "infrastructure" in product-engineering context can be "工程基建." "Build for a million users" should often become "追求能服务一百万用户的工程基建", not "为一百万用户而构建."

Common Chinese Failure Modes

Watch for these recurring translation problems and fix the mechanism, not just the word:

• Pronoun drift: English "it", "this", "that", and "the work" often become unclear in Chinese. Restate the noun: "这个产品", "这种信念", "真正要做的事", "这次曝光."
• Abstract literalism: words like "防御", "裁决", "合法", "材料", "涂满", "很窄", "昂贵地挣来", or "承受用户" may be accurate to the English skeleton but unnatural in Chinese. Replace them with the concrete action or judgment the sentence means.
• Dangling contrast: if a sentence says "但..." or "相反..." after a translated claim, make the contrast explicit in Chinese. Do not assume the English paragraph rhythm will carry it.
• Unintroduced examples: if a condensed passage mentions a diamond pickaxe, a launch video, a benchmark, or a product codename, include enough local context for the example to make sense on its own.
• English metaphor leakage: "spark/fuel", "machine in the room", "muscle", and similar images may need replacement or expansion. Prefer the Chinese mechanism when the metaphor distracts.
• Nominalized English: phrases like "the proof is", "the job is", "the translation is", or "the test is" often become stiff. Convert them into Chinese causal or action sentences.

Use Chinese Main Text With English Term Anchors

When a term has technical precision, put Chinese first and English in parentheses on first use:

• 开放权重模型（open-weight models）
• 编程智能体（coding agents）
• 推理轨迹（reasoning traces）
• 前沿模型（frontier model）
• 守门人（gatekeeper）
• 基准测试（benchmark）
• 递归自我改进（recursive self-improvement, RSI）
• 事故报告（incident reporting）
• 相互可见性（mutual visibility）
• 共享底座（shared substrate）
• 许可制俱乐部（permissioned club）

Do not leave dense English clusters in Chinese prose. If several English terms appear in one paragraph, translate the paragraph's conceptual load into Chinese and keep only the necessary anchors.

Localize Names And Objects Readers Know

Use common Chinese names where a Chinese reader would expect them:

• Jensen Huang -> 黄仁勋
• Huawei -> 华为
• Huawei Ascend -> 华为昇腾 or 昇腾
• Jie Tang -> 唐杰
• Elon Musk -> 马斯克

Keep original English inside citation titles, URLs, source metadata, and direct quotes.

Choose The Chinese Frame, Not The English Label

For recurring concepts, pick the Chinese frame that carries the argument and keep it stable. If "access denial" functions like supply cutoff in the Chinese argument, use "断供" for the strategic concept, while preserving "访问权限" or "访问路径" for literal API or product-access mechanics.

Avoid switching among near-synonyms such as "拒绝访问," "访问拒绝," "访问控制," and "断供" unless each one marks a real distinction.

MDX Notes And Citation Placement

For MDX essays that use <Note>:

• Put the note immediately after the claim, phrase, or clause it supports.
• In Chinese body prose, when the note supports the preceding clause or sentence, place <Note> before the sentence punctuation and put the punctuation after </Note>. This keeps the rendered note number before the punctuation.
• Do not leave English note prose such as "bloat, waste, and rookie mistakes" inside Chinese notes unless it is a direct quoted phrase that needs to stay in English.
• A note should add evidence, source detail, or context. It should not merely confess uncertainty, narrate the editing process, or explain that the author is simplifying.
• When moving a source detail into a note, make sure the main sentence still reads cleanly without opening the note.

Explain Metaphors Or Replace Them

English metaphors often do not survive directly in Chinese. If a metaphor is not immediately legible, either replace it or expand it into the mechanism.

Example:

• Weak: "你手里有一个旋钮。如果你把线剪断，你就失去了这个旋钮。"
• Stronger: "只要竞争对手还依赖你，你就仍然能影响它的选择。价格、速度、条款、可用性，都可以成为杠杆。一旦你把这条依赖切断，对方的目标就会变得简单得多：尽快摆脱你。"

Use Familiar Chinese Phrases Only When Grounded

Chinese idioms and political-philosophy phrases can add force, but only when tied to the essay's mechanism. For example, "历史不是原地打转，而是螺旋上升" works when immediately grounded in the specific claim that each round of catch-up raises the baseline for the next round.

Do not leave a slogan standing alone.

Keep The Argument's Causal Boundary Clear

When evidence supports sequence and pressure but not direct causality, say so in natural Chinese:

• "这未必能证明某一次切断直接导致了某一个模型。"
• "我的假设是..."
• "它很可能缩短了反应时间。"

Then state the strategic mechanism concretely:

• "一旦访问变得不可靠，自食其力、自给自足就不再是口号，而是重要且紧急的任务。"

Polish Section By Section

For Chinese drafts, review one section at a time. In each section:

1. Identify the paragraph's job in the argument.
2. Remove English terms that are not needed for precision.
3. Convert literal translations into Chinese causal relationships.
4. Make recurring terms consistent.
5. Keep direct quotes and citation metadata faithful to the source.
6. Read the rendered paragraph as a Chinese reader would.

Maintain Condensed Reading Layers

If an essay has multiple reading depths such as Spine, Argument, and Full, treat the condensed layers as editorial surfaces, not summaries generated from scratch:

• Preserve canonical headings or commandments verbatim when the user has asked for exact wording.
• Argument should be a close extraction from Full, with light stitching only where needed for readability. It is not a study guide, a rewrite, or a new outline.
• Every condensed excerpt must be self-contained. Remove dangling phrases like "we learned this three times" if the excerpt only includes one example, or add the missing setup.
• When terminology changes in Full, sync the matching Argument excerpt.
• If source examples are too abrupt in Argument, either include the setup from Full or choose a different excerpt that already carries its own context.
• Keep the default reading experience and selector order intentional; do not change reading-depth defaults while line-editing prose unless the user asks.

Workflow

1. State the essay's thesis in one sentence.
2. State the opponent's strongest position in one sentence — or, if there is no named opponent, the strongest objection a skeptical reader would raise.
3. Identify any framing that belongs to the author rather than the opponent.
4. Mark where the essay overclaims causality, certainty, motive, or evidence.
5. Identify the main argument spine: setup, opposition, turn, proof, implication, ending.
6. Move source detail, caveats, quotes, and secondary evidence into notes when they slow the spine.
7. For each citation, name its job. Delete citations with no job. Confirm each surviving claim traces to a source the reader can see, verified against the primary artifact.
8. Add or tighten concessions where they make the argument more credible — and keep each one to its shortest form.
9. Convert weak causal claims into incentive-chain claims when the evidence supports sequence and pressure but not proof.
10. If the essay has translations, mirror meaning and structure across versions; let surface phrasing read naturally in each language, and flag any place the versions drift into different claims.
11. If the essay has condensed reading layers, sync terminology and examples across Spine, Argument, and Full, and verify each condensed excerpt stands alone.
12. Render locally and inspect the reading experience before finishing.

Review Checklist

• Does the essay attack the opponent's real premise rather than a convenient label?
• If there is no named opponent, does the essay still answer the strongest objection a skeptical reader would raise?
• Does it acknowledge when a key phrase is the author's framing?
• Does each note add evidence, quote, context, or source detail?
• Do any notes sound like editorial self-criticism?
• Does the essay concede what must be conceded?
• Is each concession as short as it can be — concede, reframe, rule — without swelling into its own essay?
• Does it distinguish a plausible mechanism from the conclusion drawn from that mechanism?
• Are causal claims supported, or should they become incentive claims?
• Does every citation have a clear job?
• Does every framing claim trace to a source the reader can see, verified against the primary artifact?
• Is the main text still readable without opening the notes?
• Does the rendered page look and read cleanly?
• Across translations, do the versions make the same claims (phrasing may differ; meaning must not)?
• In Chinese MDX, do note markers render before sentence punctuation when they attach to the preceding claim?
• If the essay has reading-depth layers, are Spine and Argument close to the canonical text, self-contained, and synchronized with Full?

Output Style

When reviewing, lead with the highest-leverage structural issues before line edits. Be direct about weak arguments, strawmen, overclaims, citation clutter, and notes that undercut the essay.

When editing, preserve the user's authorship. Prefer targeted rewrites, paragraph inserts, note rewrites, and structural moves over replacing the whole essay unless the user asks for a full redraft.