Agent skill

Dialectic

by umputun in umputun/cc-thingz

Prove and counter-prove a statement using parallel agents to eliminate confirmation bias.

MITAuto-check: notesAgent Workflows

Install Dialectic

skills CLI
$ npx skills add umputun/cc-thingz --skill dialectic -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install umputun/cc-thingz dialectic --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/umputun/cc-thingz.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/thinking-tools/skills/dialectic .claude/skills/dialectic && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dialectic
GitHub stars
483
Token cost
~756 tokens
SKILL.md length
279 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

Prove and counter-prove a statement using parallel agents to eliminate confirmation bias.

  • Works in 3 steps: Launch Parallel Agents → Synthesize → Verify
  • Someone says dialectic
  • SKILL.md covers Process, Use Cases and Key Principles
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Dialectic is an agent skill from umputun/cc-thingz. Prove and counter-prove a statement using parallel agents to eliminate confirmation bias. Use when someone says "dialectic", "prove/disprove", "stress test this claim", "is this really true", "argue both sides", or when a statement needs objective analysis from opposing viewpoints.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Subagents and Load testing. The repository describes itself as: various things for claude code. The licence is MIT.

When your agent uses it

  • Someone says dialectic
  • Stress test this claim
  • Is this really true
  • Argue both sides

Example prompts

  • “dialectic”
  • “prove/disprove”
  • “stress test this claim”
  • “/dialectic”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Grep, Glob, Task, AskUserQuestion

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Launch Parallel Agents
  2. Synthesize
  3. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit 99e1c8d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Grep
    • Glob
    • Task
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dialectic loads about 756 tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 279 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~756

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Grep, Glob, Task, AskUserQuestion

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from umputun/cc-thingz at commit 99e1c8d, republished under its MIT licence (© umputun). 279 words, ~756 tokens.

Download SKILL.mdSave it as .claude/skills/dialectic/SKILL.md (or your agent's skills folder).
name
dialectic
description
Prove and counter-prove a statement using parallel agents to eliminate confirmation bias. Use when someone says "dialectic", "prove/disprove", "stress test this claim", "is this really true", "argue both sides", or when a statement needs objective analysis from opposing viewpoints.
allowed-tools
Bash, Read, Grep, Glob, Task, AskUserQuestion
argument-hint
<statement to analyze>

Dialectic Analysis

Objective analysis of a statement by running two agents with opposing goals in parallel, then synthesizing findings.

Process

Step 1: Launch Parallel Agents

CRITICAL: Both Task tool calls MUST be in a single message for true parallel execution. Do NOT use run_in_background. Do NOT launch sequentially. Foreground agents in the same message run in parallel and block until both complete.

Agent 1 (Thesis) — find all POSITIVE evidence:

  • what works well, improvements, correct patterns
  • supporting facts, proof the statement is TRUE
  • benefits, strengths, successful outcomes

Agent 2 (Antithesis) — find all NEGATIVE evidence:

  • what's problematic, issues, risks, anti-patterns
  • edge cases, proof the statement is FALSE
  • weaknesses, failure modes, hidden costs

Both agents must provide specific file paths and line numbers when analyzing code.

Step 2: Synthesize

After both agents complete, synthesize findings into an objective conclusion:

  • weigh evidence from both sides
  • identify where thesis and antithesis agree (strongest signal)
  • note unresolved tensions
Step 3: Verify

CRITICAL — after presenting the synthesis, verify it against actual implementation:

  • read the specific files and line numbers referenced by both agents
  • confirm the evidence cited actually exists in the codebase
  • check the implementation flow matches the claims made
  • verify the synthesis accurately reflects the actual code context
  • identify any misinterpretations or missing context from agent reports
  • revise synthesis if verification reveals inaccuracies

Use Cases

Architecture decisions:

/thinking-tools:dialectic this microservice split improves maintainability

Bug analysis:

/thinking-tools:dialectic the connection pool fixes the timeout issue

Performance claims:

/thinking-tools:dialectic caching reduced database load by 80%

Refactoring safety:

/thinking-tools:dialectic extracting this interface simplifies testing

Code review:

/thinking-tools:dialectic this implementation is thread-safe

Review changes:

/thinking-tools:dialectic review the changes in server.go

Key Principles

  • Eliminate confirmation bias — examining both sides simultaneously prevents anchoring on the first conclusion
  • Evidence-based — agents must cite specific files, lines, and facts, not general claims
  • Verification required — synthesis must be checked against actual code before presenting
  • Objective conclusion — the goal is truth, not winning either side

© umputun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/thinking-tools/skills/dialectic of umputun/cc-thingz.

Open the folder on GitHubat commit 99e1c8d

Compare with similar skills

Dialectic next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dialectic compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dialectic this skillumputun/cc-thingz483—~756Automated safety check: NotesMIT
Adversarial ReviewDanMcInerney/architect-loop626—~1.1kAutomated safety check: PassMIT
The Jurytech-leads-club/agent-skills7k—~4.5kAutomated safety check: PassCC-BY-4.0
Claude Code Agent Developmentanthropics/claude-plugins-official37k8 repos~2.8kAutomated safety check: PassApache-2.0
Grillingbestofjs/bestofjs3.1k30 repos~464Automated safety check: PassMIT
Subagent Driven DevelopmentAsvarox/allkaraoke26137 repos~1.2kAutomated safety check: PassNone

Similar skills

  • Adversarial Review

    DanMcInerney/architect-loop

    A skill your agent uses when the architect factory orchestrator dispatches a fresh strategist subagent to harden a draft spec: falsify it with file:line evidence, fold the surviving findings into a…

    626 GitHub stars~1.1k tokensUpdated 24 days ago
    Agent WorkflowsAuto-check passed
  • The Jury

    tech-leads-club/agent-skills

    A skill your agent uses when a question, decision, plan, tradeoff, or claim needs a rigorous verdict and one perspective is not enough.

    7k GitHub stars~4.5k tokensUpdated 17 days ago
    Agent WorkflowsAuto-check passed
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    37k GitHub starsUsed in 8 repos~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Grilling

    bestofjs/bestofjs

    Grill the user relentlessly about a plan, decision, or idea.

    3.1k GitHub starsUsed in 30 repos~464 tokens
    Agent WorkflowsAuto-check passed
  • Subagent Driven Development

    Asvarox/allkaraoke

    A skill your agent uses when executing implementation plans with independent tasks in the current session

    261 GitHub starsUsed in 37 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Dispatching Parallel Agents

    ultralisp/ultralisp

    A skill your agent uses when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

    258 GitHub starsUsed in 40 repos~1.5k tokens
    Agent WorkflowsAuto-check passed

More from umputun/cc-thingz

All 16 skills in this repo
  • Exec

    umputun/cc-thingz

    Execute plan tasks sequentially using subagents. An agent skill from umputun/cc-thingz.

    483 GitHub stars~8k tokensUpdated 2 days ago
    Auto-check passed
  • New

    umputun/cc-thingz

    A skill your agent uses when user asks to create a release, cut a release, or publish a version.

    483 GitHub stars~1.9k tokensUpdated 2 days ago
    Auto-check: notes
  • Root Cause Investigator

    umputun/cc-thingz

    Systematic root cause analysis for errors, bugs, and unexpected behaviors using 5-Why methodology.

    483 GitHub stars~879 tokensUpdated 2 days ago
    Auto-check passed
  • Ask Codex

    umputun/cc-thingz

    Consult OpenAI Codex for investigation, debugging, or code review.

    483 GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check: notes
  • Backlog

    umputun/cc-thingz

    Read, work, and maintain a Git repo's deferred-work items in docs/backlog/, one file per item.

    483 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check: notes
  • Brainstorm

    umputun/cc-thingz

    Use before any creative work or significant changes. An agent skill from umputun/cc-thingz.

    483 GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check: notes

Categories

Questions about Dialectic

What does Dialectic do?

Prove and counter-prove a statement using parallel agents to eliminate confirmation bias. Dialectic is an agent skill from umputun/cc-thingz. Prove and counter-prove a statement using parallel agents to eliminate confirmation bias.

When should I use Dialectic?

Dialectic fits situations like: someone says dialectic; stress test this claim; is this really true; argue both sides.

How do I install Dialectic in Claude Code?

Run `npx skills add umputun/cc-thingz --skill dialectic -a claude-code`. Or copy the skill folder (plugins/thinking-tools/skills/dialectic in umputun/cc-thingz) into .claude/skills/dialectic in your project. Claude Code loads it when a task matches its description.

How do I install Dialectic in Codex?

Run `npx skills add umputun/cc-thingz --skill dialectic -a codex`. Or copy the skill folder (plugins/thinking-tools/skills/dialectic in umputun/cc-thingz) into .agents/skills/dialectic in your project. Codex loads it when a task matches its description.

Can I use Dialectic in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add umputun/cc-thingz --skill dialectic -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dialectic, .gemini/skills/dialectic, .github/skills/dialectic and .opencode/skills/dialectic in your project.

What does Dialectic need to run?

SKILL.md names no scripts, command-line tools or credentials: Dialectic is instructions for the agent only. Its frontmatter pre-approves these tools: Bash, Read, Grep, Glob, Task, AskUserQuestion.

Does Dialectic access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dialectic safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Dialectic use?

Dialectic is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dialectic use?

About 756 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dialectic?

Skills that share tags, products or a category with Dialectic: Adversarial Review (DanMcInerney/architect-loop, 626 stars), The Jury (tech-leads-club/agent-skills, 7k stars), Claude Code Agent Development (anthropics/claude-plugins-official, 37k stars) and Grilling (bestofjs/bestofjs, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dialectic?

umputun (a GitHub user) maintains it in umputun/cc-thingz, which has 483 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 5, 2026.

Source: umputun/cc-thingz on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.