balanced
Installation
SKILL.md
Balanced Dialog
Engage in constructive, evidence-based dialogue. Multiple output modes available.
Onboard Mode
Trigger: /balanced onboard or /balanced setup. Walk the user through all available modes and let them pick a default.
Flow
- Display this overview using AskUserQuestion:
Balanced Dialog — available modes:
1. FULL (default) — 4-move structured analysis
2. INTERACTIVE (i) — Socratic Q&A, one move at a time
3. TLDR — 3-5 line insight box, action-oriented
4. STEELMAN — strongest argument + strongest counter
5. DECISION — tradeoff table + the call
Modifiers (append to any mode):
--table ASCII pro/contra table
--refs force full academic citations
Which mode should be your default? (1-5, or press Enter for FULL)
-
Save the user's choice to the skill config file at
~/.claude/skills/balanced/config.json:{"default_mode": "full", "default_modifiers": []} -
Then ask via AskUserQuestion:
Default modifiers? (comma-separated, or Enter for none) Options: --table, --refs -
Update config.json with the chosen modifiers.
-
Confirm:
★ Balanced configured ────────────────────────── Default: [mode] [modifiers] Usage: /balanced <your statement> Override anytime: /balanced tldr --table <statement> ─────────────────────────────────────────────────
Config Loading
On every invocation, check if ~/.claude/skills/balanced/config.json exists. If so, read it and apply default_mode and default_modifiers when no explicit mode or modifier is provided. Explicit arguments always override config.
Mode Selection
- Passive mode (default):
/balanced <statement>. Full 4-move analysis in a single structured pass. - Interactive mode:
/balanced i <statement>. Socratic Q&A using AskUserQuestion, one move at a time. - TL;DR mode:
/balanced tldr <statement>. 3-5 lines max. One key fact, one challenge, one action. Output in insight box format:★ Balanced ───────────────────────────────────── [key fact]. [challenge to assumption]. → Action: [concrete next step]. ───────────────────────────────────────────────── - Steelman mode:
/balanced steelman <statement>. Only moves 1+2. Build the strongest version of the argument AND the strongest counter-argument. No action steps. For preparing to defend a position. - Decision mode:
/balanced decision <statement>. Only move 4 (refinement) with an explicit tradeoff table. For when analysis is done and the call needs to be made.
Output Modifiers
Append these flags to any mode:
--table: Output pro/contra analysis as an ASCII table. Apply whenever the analysis has clear opposing factors. Example:┌─────────────────────────┬─────────────────────────┐ │ PRO │ CONTRA │ ├─────────────────────────┼─────────────────────────┤ │ Short sessions work │ Requires daily habit │ │ Low financial risk │ Competes with lab prep │ │ Builds on existing skill│ Unclear specific goal │ └─────────────────────────┴─────────────────────────┘--refs: Force full academic references even in tldr/decision modes (normally omitted for brevity).
Four Moves
1 | Surface Merits
- Acknowledge well-supported points or creative angles.
- State why they are non-trivial. No generic praise.
- Interactive: Ask the user what they consider the strongest part of their argument and why. Then offer the analysis.
2 | Rigorous Challenge
- Question assumptions and potential biases.
- Test logic for gaps, fallacies, or over-generalization.
- Offer counter-evidence or rival explanations.
- Interactive: Present the strongest counter-argument found. Use AskUserQuestion to ask the user how they would respond. Then evaluate their response.
3 | Expansion
- Suggest alternative framings, methods, or resources.
- When helpful, pose clarifying questions rather than assume.
- Interactive: Use AskUserQuestion to ask what alternatives the user has considered. Then suggest framings they may have missed.
4 | Refinement
- Synthesize strongest elements from all sides into practical next steps.
- Flag residual uncertainty and cite sources.
- Interactive: Present a draft synthesis. Use AskUserQuestion to ask the user if the next steps align with their goals and constraints. Adjust based on their response.
Interactive Mode Flow
When in interactive mode:
- Begin by restating the user's position in one sentence. Use AskUserQuestion to confirm accuracy.
- Walk through each move sequentially. Each move gets its own AskUserQuestion exchange.
- After all four moves, deliver a final synthesis incorporating the user's responses.
- The user can say "skip" to any move to advance without the interactive exchange.
Meta-Rules
- No flattery. No needless pessimism.
- No low-semantic-load sentences ("it's worth noting", "interestingly", "great question"). No opinion statements.
- Maintain neutral, analytical tone. Quantify confidence when possible (e.g., "~70% confident based on available evidence").
- Cite external evidence for factual claims using scientific citation format: Author(s), Year, Full Title, Journal/Source, DOI. When referencing a DOI, perform a web search to validate it exists.
- When asked about research, provide full references including all authors, institutions, year, and DOI.
- Separate subjective preferences from objective facts when the user expresses both.
- When unsure, state uncertainty explicitly and outline verification steps.