Counterargument Handler

v1.0.0

Anticipate, acknowledge, and respond to reader objections and alternative views in a research argument. Use this skill when the user has a draft argument or...

0· 56·0 current·0 all-time
byHung Quoc To@quochungto

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for quochungto/bookforge-counterargument-handler.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "Counterargument Handler" (quochungto/bookforge-counterargument-handler) from ClawHub.
Skill page: https://clawhub.ai/quochungto/bookforge-counterargument-handler
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install bookforge-counterargument-handler

ClawHub CLI

Package manager switcher

npx clawhub@latest install bookforge-counterargument-handler
Security Scan
Capability signals
CryptoCan make purchases
These labels describe what authority the skill may exercise. They are separate from suspicious or malicious moderation verdicts.
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
Purpose & Capability
Name, description, and declared dependency (research-argument-builder) match the content of SKILL.md and reference documents. The skill only asks for user argument text and produces acknowledgment/response pairs — no unrelated capabilities are requested.
Instruction Scope
SKILL.md contains detailed, bounded instructions for analyzing a user's argument and producing templates and responses. It does not instruct the agent to read system files, call external endpoints, or access credentials. All requested inputs are textual (claim, reasons, evidence).
Install Mechanism
No install spec or code files beyond documentation; this is instruction-only, so nothing is written to disk and no third-party packages are installed.
Credentials
The skill requires no environment variables, binaries, or config paths. The declared dependency on research-argument-builder is logical and proportional to the stated workflow.
Persistence & Privilege
always is false and the skill does not request persistent presence or system changes. disable-model-invocation is false (normal default) — the skill can be invoked autonomously by the agent, which is expected for user-invocable skills and not flagged on its own.
Assessment
This skill is an instruction-only writing helper and appears coherent with its purpose. Before installing, note: (1) it will operate on whatever draft text you provide — do not submit sensitive or unpublished material if you are concerned about privacy; (2) the skill may be invoked autonomously by agents unless you change agent settings (disable-model-invocation is false by default); (3) it depends on research-argument-builder — check that dependent skill's permissions and behavior before use; and (4) outputs are templates and rhetorical guidance, not factual verification — review suggestions for accuracy, fairness, and disciplinary norms before inserting into published work.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

📚 Clawdis
academic-writingvk97186qctth72tj5y5awj92w3x85hw4wargumentationvk97186qctth72tj5y5awj92w3x85hw4wbookforgevk97186qctth72tj5y5awj92w3x85hw4wcounterargumentsvk97186qctth72tj5y5awj92w3x85hw4wcritical-thinkingvk97186qctth72tj5y5awj92w3x85hw4wlatestvk97186qctth72tj5y5awj92w3x85hw4wresearch-methodologyvk97186qctth72tj5y5awj92w3x85hw4w
56downloads
0stars
1versions
Updated 2d ago
v1.0.0
MIT-0

Counterargument Handler

When to Use

You have assembled the core of your argument — a claim backed by reasons and evidence. Now you need to do what separates a thin argument from a persuasive one: anticipate what skeptical readers will say, decide which objections to address, and respond in a way that is honest, precise, and targeted.

An argument that presents only its own case looks one-sided. Readers who hold different views will feel dismissed, not persuaded. But an argument that acknowledges every possible objection loses focus and exhausts readers. The goal is calibrated engagement: acknowledge what readers care about, respond in proportion to the weight of the objection, and direct criticism at ideas rather than people.

This skill covers the full acknowledgment-response workflow:

  1. Anticipate — question your argument as your most skeptical readers will
  2. Identify — recognize the three types of disagreements that are almost always predictable
  3. Filter — decide what to acknowledge (Goldilocks: not too many, not too few)
  4. Choose a strategy — rebut, qualify, or concede-and-reframe
  5. Write it — use vocabulary calibrated to the weight you give each objection

Preconditions to verify:

  • Does the user have a core argument (claim + reasons + evidence)? If not, invoke research-argument-builder first.
  • Can the user state their main claim in one or two sentences? If not, that is a sign the argument itself is not yet assembled — return to research-argument-builder.

Context and Input Gathering

Required (ask if missing)

  • The main claim: What the argument asserts. One or two sentences.

    • Check prompt for: thesis statement, main conclusion, storyboard from research-argument-builder
    • If missing, ask: "What is the main point you want readers to accept?"
  • The reasons and any evidence summary: The logical structure of the argument.

    • Check prompt for: storyboard output, outline, or any ordered set of assertions and sources
    • If missing, ask: "What are the two or three main reasons your claim is true?"

Useful (gather from environment if available)

  • Sources or bibliography: Other researchers' positions reveal what alternatives and objections exist in the field

    • Look for files like sources.md, bibliography.md, notes.md in the working directory
    • If found, scan for positions that differ from the user's claim before asking the user to generate objections from memory
  • Research question and intended audience: Determines which objections are most salient

    • If not stated, ask: "Who are the readers — what is their field, level, and likely stake in a different outcome?"

Process

Step 1 — Run the Objection Anticipation Protocol

WHY: You know your argument too well to see its weaknesses clearly. You believe in it too much to challenge it seriously. The only way out is to deliberately adopt the perspective of someone who wants you to be wrong — a skeptical reader with a stake in a different outcome. Doing this systematically before readers actually raise objections gives you time to fix real problems and to prepare responses for apparent ones.

Work through each element of the argument in order. For each, ask the questions below and note every objection you cannot immediately dismiss:

On the problem definition:

  • "Why do you think there's a problem at all? The costs or consequences don't seem that significant."
  • "Have you defined the problem correctly? Maybe it involves a different issue than the one you raise."

On the claim:

  • "Have you stated this too strongly? I can think of exceptions and limitations."
  • "Is your solution practical or conceptual — and does it match the type of problem you've identified?" (Practical problems need practical solutions; conceptual problems need conceptual ones.)

On why your solution is better than alternatives:

  • For a practical claim: "What you propose will cost too much and create new problems."
  • For a conceptual claim: "This doesn't fit with other well-established knowledge."

On the evidence:

  • Nature: "I want a different sort of evidence — hard numbers, not anecdotes (or lived experience, not cold numbers)."
  • Accuracy: "The numbers don't add up."
  • Precision: "What do you mean by 'many'? You need to be more specific."
  • Currency: "There is newer research on this."
  • Representativeness: "You didn't get data on all the relevant groups."
  • Authority: "Your source is not an expert on this."
  • Sufficiency: "One data point is not enough to support this."

After this pass, sort your objections into two lists:

  • Fixable before you draft: Genuine weaknesses in the argument — fix them now, do not just acknowledge them.
  • Apparent but not real, or unfixable: Objections you can address with acknowledgment and response.

For any fixable weakness: go back and fix it. Acknowledging a flaw you could have fixed signals incompetence; hiding it signals dishonesty. Neither serves you.

Step 2 — Identify the Three Predictable Disagreements

WHY: Three kinds of alternatives appear in almost every research argument, regardless of field. Recognizing them by type lets you address them systematically rather than being surprised when readers raise them. If you argue about causes, expect competing causes. If you make broad claims, expect counterexamples. If your argument turns on a contested term, expect definitional challenges.

Disagreement Type 1 — Competing causes

Applies when: your argument is about cause and effect.

No effect has a single cause. If you argue that X causes Y, every reader will think of other causes. You do not need to defeat every competing cause — but you need to acknowledge the most prominent ones and explain either why they are less important than your cause or why your cause is the focus of this argument.

Example: Arguing that pesticide use is causing honeybee colony collapse. Predictable competing causes: habitat loss, disease, parasites, genetically modified crops. Acknowledge the most prominent and explain your scope.

Disagreement Type 2 — Counterexamples

Applies when: you make any generalization.

Readers will think of exceptions they believe undermine your claim. You must think of them first, acknowledge the more plausible and vivid ones, and explain why you do not consider them as damaging as readers might. Be especially vigilant when your claim covers a phenomenon with wide natural variation — readers who do not understand statistical reasoning will focus on aberrant cases.

Example: Arguing about climate warming trends. A reader might cite a cold summer in one location. Acknowledge that local variation exists; explain why it does not invalidate a trend across decades and geographies.

Disagreement Type 3 — Definitional scope disputes

Applies when: your argument depends on a key term that has more than one plausible meaning.

Readers must accept your definition to accept your claim. They will often redefine terms to suit their own views. When your argument hinges on a term, define it with a supporting sub-argument — not a dictionary citation — and acknowledge plausible alternative definitions. Explain why you have adopted your definition.

Example: Arguing that social media is "addictive." Readers may define addiction as requiring physical dependence; you may mean behavioral compulsion. Acknowledge the definitional dispute; argue for the definition your evidence supports; explain why alternative definitions do not fit your research context.

Do NOT cite a dictionary as your definitional authority. Dictionaries record usage; they do not resolve contested meaning in specialized arguments.

Step 3 — Apply the Goldilocks Filter

WHY: Too many acknowledgments lose the argument. Too few make you seem ignorant of or dismissive toward your readers' views. The filter is not about being nice to every opposing idea — it is about strategic, credibility-building engagement with the objections readers actually care about.

Prioritize acknowledging the following — in roughly this order of importance:

  1. Plausible charges of weakness you can rebut. These are objections that seem serious at first but are not — acknowledging and rebutting them actively strengthens your case.
  2. Alternative lines of argument that are important in your field. Failing to engage with the major alternative positions in your field signals that you have not done the research.
  3. Alternative conclusions that readers want to be true. Readers with a stake in a different outcome need to see you have considered their preferred position and can explain why yours is better.
  4. Alternative evidence readers know about. If readers know of a study or data set that points in a different direction, ignoring it looks deliberate.
  5. Important counterexamples you must address. Vivid, memorable exceptions that readers will immediately think of.

What to set aside: Objections that are obviously frivolous, easily dismissed without argument, or so minor that noting them at all inflates their importance. Better to ignore what readers like than to disparage it — disparaging it weakens your credibility; ignoring something minor wastes no one's time.

Important constraint on tone: Do not denigrate those you disagree with in the acknowledgment. Label the work, not the person: write "the evidence here is thin" not "naive researchers have claimed." Save critical characterization for the response portion, and direct it at the argument rather than the author.

Step 4 — Choose a Response Strategy

WHY: The response is not just a counter-claim. Every response is itself a mini-argument — it needs at least one reason, and for substantial objections, it needs its own evidence. Choosing the right strategy before drafting prevents you from either conceding too much (weakening the original argument) or asserting without reasoning (which is not a response, it is just a louder version of the original claim).

Three response strategies, from most to least accommodating:

Strategy A — Rebut

Use when: the objection is based on a misunderstanding of your scope, a factual error, or reasoning that does not hold under scrutiny.

Structure: Acknowledge the objection → give the reason it does not apply or is incorrect → provide supporting evidence if readers do not already know the basis for your response.

Minimum form: [Acknowledgment phrase] + [reason the objection fails or misses the point] Full form: [Acknowledgment phrase] + [reason] + [sub-reason or evidence backing the reason]

Strategy B — Qualify

Use when: the objection identifies a genuine limitation on your claim, but the claim is still valid within a defined scope. Do not fight a legitimate narrowing — concede it, restate the bounded claim, and move on. A scoped claim that holds is worth more than an overbroad claim that does not.

Structure: Acknowledge that the objection applies in certain cases → restate your claim with an explicit qualifier → show that the bounded claim is still significant.

Example: "We acknowledge this pattern does not hold in the earliest periods of industrialization; our claim applies to the period after 1850, when the relevant conditions stabilized."

Strategy C — Concede-and-reframe

Use when: the objection identifies a real flaw in your argument that you cannot fix and cannot rebut. This is the hardest case but also the most honest one.

Three moves are available:

  • The rest of your argument more than balances the flaw — state this explicitly and show why.
  • While the flaw is serious, more research would show a way around it — frame this as a limitation and a future direction.
  • While the flaw makes it impossible to accept your claim fully, your argument offers important insight into the question and suggests what a better answer would require — reframe the contribution.

What you cannot do: Ignore a flaw that readers will notice. If readers see it and you have not mentioned it, they conclude you lack competence. If they think you saw it and hid it, they conclude you lack honesty. Either outcome is worse than the concession.

Step 5 — Write the Acknowledgment-Response Pairs

WHY: The vocabulary of acknowledgment does work that the logic alone cannot do — it signals to readers exactly how much weight you give an objection. Using the wrong register (too dismissive or too deferential) misrepresents your actual position. Precise vocabulary controls the reader's interpretation of your credibility as an honest, informed interlocutor.

Acknowledgment vocabulary — five levels, from most to most deferential:

Level 1 — Downplay: signals you consider the objection minor but worth noting.

  • Introduce with: despite, regardless of, notwithstanding
  • Or as a subordinate clause: although, while, even though
  • Example: "Although some researchers have attributed this pattern to seasonal variation, our analysis of five-year trends..."

Level 2 — Hedged acknowledgment: signals partial validity without full concession.

  • Introduce with: seem, appear, may, could; adverbs like plausibly, justifiably, reasonably, surprisingly
  • Example: "This proposal may have some merit, but the evidence for scalability..."

Level 3 — Unnamed source acknowledgment: gives the objection some weight without elevating a specific source.

  • "It is easy to think / imagine / claim that..." followed by your response
  • "Some evidence might suggest / indicate / point to..." followed by your counter-evidence
  • Example: "It is easy to imagine that shorter deadlines improve output quality, but the data on revision depth..."

Level 4 — Named community acknowledgment: gives the objection significant weight by attributing it to researchers or critics in the field.

  • "Some / many / a few researchers / critics / scholars have argued that..." followed by response
  • "Although some researchers have argued that..., our findings show..."
  • Caution: If you attribute a position to a named person or group, do not characterize them negatively before your response. Write "Smith's evidence is important" not "the occasionally careless Smith." Save critique for the response and direct it at the work.

Level 5 — First-person concession: your own voice conceding validity; highest weight given to the objection.

  • "I / we understand / know / realize that..., but..."
  • "It must / should be admitted / acknowledged / conceded that..., nevertheless..."
  • "Granted / Certainly / To be sure / Of course, X has argued that..., however..."
  • Example: "Admittedly, our sample does not cover the Southern states, where conditions differ substantially; nevertheless..."

Response vocabulary:

Begin the response with a term or phrase that signals the pivot: but, however, on the other hand.

Response registers, from tactful to blunt:

  • Tactful: "But I do not quite understand how / I find it difficult to see how / It is not clear to me how X can claim that..."
  • Noting unsettled issues: "But there are other issues here... / But there remains the problem of..."
  • Claiming irrelevance: "But as insightful as that may be, it ignores / is irrelevant to / does not bear on the issue at hand."
  • Challenging the reasoning or evidence: "But the evidence is unreliable / shaky / thin." "But the argument is untenable / weak / confused / simplistic." "But the argument overlooks / ignores / misses key factors."
  • Noting incomplete analysis: "Smith's evidence is important, but we must look at all the available evidence." "That explains some of the problem, but it is too complex for a single explanation." "That principle holds in many cases, but not in all."

See references/acknowledgment-response-vocabulary.md for the complete vocabulary list organized by register.

Step 6 — Produce the Acknowledgment Map

WHY: The acknowledgment map externalizes the full set of decisions made in Steps 1-5 into a format that can be inserted directly into the argument storyboard or draft plan. Without it, acknowledgment-response decisions made in the planning phase get lost or inconsistently applied in drafting.

Produce one entry per acknowledged objection, using this format:

OBJECTION: [state the objection in the reader's voice — one sentence]
Type: [competing causes / counterexample / definitional scope / evidence quality / other]
Weight given: [low / medium / high]
Response strategy: [rebut / qualify / concede-and-reframe]
Acknowledgment phrase: [draft opening clause with vocabulary from Step 5]
Response: [one to three sentences: the reason the objection fails, the qualifier, or the concession + reframe]
Insert point: [where in the argument this acknowledgment should appear — reason #, section name, etc.]

After producing the full map, count the acknowledgments. If there are more than four or five for a medium-length argument, apply the Goldilocks filter again — remove entries in the "low weight / easily dismissed" category unless they are known to be prominent in the field.

Examples

Example 1 — Competing causes objection in a cause argument

Argument: School lunch nutrition policies reduce childhood obesity rates in low-income districts.

Predictable objection (Type 1 — competing causes): "Physical activity levels, home food environment, and socioeconomic status all affect obesity rates. You can't isolate the effect of school lunch policy."

Goldilocks filter: This is a legitimate alternative and important in the public health field. Acknowledge.

Strategy: Qualify — the argument does not claim school lunch policy is the only cause, but that it is one with measurable, independent effects.

Acknowledgment map entry:

OBJECTION: Physical activity, home food environment, and income level all contribute to
childhood obesity, making it impossible to attribute rate changes to school lunch policy alone.
Type: competing causes
Weight given: high
Response strategy: qualify
Acknowledgment phrase: "Although home food environment and physical activity independently
affect obesity rates..."
Response: "...our analysis controls for both variables across matched district pairs, isolating
the policy effect. We do not claim school lunch policy is the sole cause — our claim is that
it is a statistically significant, independently actionable factor."
Insert point: Immediately after presenting the main causal evidence (Reason 2)

Example 2 — Definitional scope dispute

Argument: Social media use among adolescents is addictive.

Predictable objection (Type 3 — definitional scope): "Addiction requires physiological dependence and withdrawal symptoms. Social media doesn't qualify — you're misusing the term."

Goldilocks filter: Definitional objection that, if not addressed, allows readers to dismiss the entire argument. Must acknowledge.

Strategy: Rebut the definitional framing — define addiction as behavioral compulsion that persists despite negative consequences, cite behavioral addiction research, explain why physiological dependence is not the defining criterion in current clinical literature.

Acknowledgment map entry:

OBJECTION: Addiction requires physiological dependence; applying the term to social media
misuses clinical vocabulary and overstates the case.
Type: definitional scope
Weight given: high
Response strategy: rebut
Acknowledgment phrase: "Some researchers maintain that addiction requires physiological
dependence and formal withdrawal symptoms..."
Response: "...however, behavioral addiction — characterized by compulsive use despite
negative consequences and inability to reduce use voluntarily — is now recognized as a
clinical category (American Psychiatric Association, 2013). We use 'addictive' in this
behavioral sense, which social media use has been shown to satisfy across multiple
validated scales."
Insert point: Within the claim definition, before presenting the supporting evidence

Example 3 — Genuine flaw requiring concede-and-reframe

Argument: Remote work policies increase individual productivity in knowledge-work firms.

Discovered flaw: The three datasets used were all from technology companies. The claim cannot be generalized to all knowledge-work firms.

Strategy: Concede the scope limitation honestly; reframe the contribution as establishing the pattern in one sector and identifying conditions that future research should test in others.

Acknowledgment map entry:

OBJECTION: All three studies draw from technology companies. The claim cannot extend to
law firms, financial services, or other knowledge-work sectors.
Type: evidence — representativeness
Weight given: high
Response strategy: concede-and-reframe
Acknowledgment phrase: "It must be acknowledged that our evidence comes entirely from
the technology sector, which may have atypically high rates of autonomous task structures..."
Response: "...this limits the generalizability of our findings. We do not claim this pattern
holds universally; our contribution is to establish the effect under known conditions and
to identify the task-autonomy variable as the most likely mechanism — which future
research can test across other sectors."
Insert point: In the limitations section; also flag in the claim with a qualifier ("in
technology-sector knowledge work firms")

Output

Produce the acknowledgment map (one entry per acknowledged objection using the Step 6 format), then provide:

  1. Objection audit summary: List every objection surfaced in Step 1, noting which are fixable (user should fix before drafting) and which are addressed in the map.
  2. Three predictable disagreement types: State which of the three types apply to this argument and what the specific objection is in each case.
  3. Goldilocks verdict: How many objections the map includes, and why those were selected over the ones set aside.
  4. Draft acknowledgment-response sentences: For each entry in the map, provide a draft sentence or two using vocabulary from Step 5, ready to be inserted into the draft.

If a fixable weakness was discovered in Step 1: flag it clearly before the acknowledgment map and state what needs to be fixed in the argument before drafting proceeds.

Anti-Pattern Quick Reference

Anti-patternSignalFix
Ignoring obvious alternativesNo acknowledgments in the draft; all competing views absentRun the objection anticipation protocol systematically; check your sources for disagreements
Acknowledging without responding"Some argue X. As we can see, Y..." — no reason why X is wrongEvery acknowledgment needs at least one reason; for substantial objections, build a sub-argument
Asserting instead of responding"But this is clearly wrong." — no reason givenAdd the reason the objection fails, then add evidence if readers need the basis for the response
Denigrating the source in the acknowledgment"Naive researchers have claimed..." "The careless historian X says..."Label the work, not the person; save criticism for the response portion and direct it at the argument
Over-acknowledgingFour or more acknowledgments in a short paperApply the Goldilocks filter; remove low-weight entries that are not prominent in the field
Hiding a genuine flawKnown limitation not mentioned; argument overstatedConcede, then reframe: state the limitation, then explain the contribution within those limits
Dictionary definition as authority"According to Merriam-Webster, 'addiction' means..."Build a sub-argument for your definition; acknowledge alternative definitions; explain your choice
Competing causes ignoredCause argument with no acknowledgment of other causesName the most prominent competing causes; explain why your cause is the focus

References

  • references/acknowledgment-response-vocabulary.md — Complete vocabulary list for acknowledgments (5 levels) and responses (4 registers), with sentence templates
  • references/three-predictable-disagreements.md — Extended guidance on competing causes, counterexample, and definitional scope disputes with field-specific examples

License

This skill is licensed under CC-BY-SA-4.0. Source: BookForge — The Craft of Research, 4th Edition by Wayne C. Booth, Gregory G. Colomb, Joseph M. Williams, Joseph Bizup, William T. FitzGerald.

Related BookForge Skills

Install related skills from ClawhHub:

  • clawhub install bookforge-research-argument-builder

Or install the full book set from GitHub: bookforge-skills

Comments

Loading comments...