Swing

Swing terminal installation

Your AI is not swinging at all.

It picks the safe default, agrees when it should push back, cites no sources, hides its reasoning, and assumes everything will work. Six cognitive failures. Six firewalls. Make it swing.

npx skills add whynowlab/swing-skills --all

Built for Claude Code | Compatible with AI agents via Agent Skills open standard
Created by @thestack_ai

See the Difference

Before: Default AI Research

You: Is SQLite viable for an app with 1000 concurrent users?

AI: No, SQLite is not suitable for high-concurrency applications. Use PostgreSQL or MySQL instead for production workloads.

After: With `swing-research`

You: /swing-research Is SQLite viable for an app with 1000 concurrent users?

AI: Yes, with caveats. 1000 concurrent users ≠ 1000 concurrent writes. Typical web apps generate ~30 concurrent write transactions at this scale. SQLite handles ~120 write transactions/sec in WAL mode (verified: sqlite.org benchmarks + Expensify production case study serving 10M+ users on SQLite). The real constraint is write contention above ~100 concurrent writers, not user count.

Sources: 🏛️ sqlite.org WAL documentation, 🛡️ Expensify engineering blog (2024), ⚠️ HN discussion (corroborated)

The baseline gave a wrong answer confidently. The skill forced source verification and reached the opposite — correct — conclusion.

Before: Default AI Code Review

You: Review this JWT auth module

AI: The code looks well-structured. Consider adding more comments and using TypeScript for better type safety. Variable naming could be improved in some places.

After: With `swing-review`

You: /swing-review Review this JWT auth module

AI:
Steel-man: JWT-based stateless auth was chosen for horizontal scaling. The 15-min access + 7-day refresh split balances security and UX.

🔴 Critical: No refresh token rotation. A stolen token grants persistent 7-day access with no detection. Fix: implement token family chain rotation.

🟠 Major: Rate limiting uses in-memory Map(). Resets on restart, bypassed in multi-instance deploys. Fix: move to Redis with TTL.

Verdict: PASS WITH CONDITIONS — must fix token rotation before deploy.

The baseline found nothing. The skill found a Critical security vulnerability.

Six Failures, Six Firewalls

Cognitive Failure	What Happens	Firewall	What It Forces
Premature closure	AI rushes to execute on ambiguous requests	`swing-clarify`	Structured clarification before execution begins
Hallucination	AI states claims without verification	`swing-research`	Source-traced, cross-verified claims with S/A/B/C tier grading
Anchoring bias	AI locks onto the first "obvious" answer	`swing-options`	5 probability-weighted options including unconventional alternatives
Confirmation bias	AI agrees with you instead of challenging	`swing-review`	Steel-man then 3-vector attack. "Looks good" is structurally banned
Black-box reasoning	AI gives conclusions without showing why	`swing-trace`	Assumption inventory and weakest-link analysis
Optimism bias	AI assumes the plan will work	`swing-mortem`	Assumes failure, identifies 5 specific failure scenarios with circuit breakers

Skills

swing-clarify

Prevents premature execution on ambiguous requests.

Request → 5W1H Decomposition → Ambiguity Score → Clarify or Proceed

Breaks every request into 6 dimensions: What, Who, Where, When, Why, How
Scores ambiguity (0-6) — clear requests get a green light, ambiguous ones get up to 3 questions
Every question includes multiple choice options and a stated default assumption
Designed to run FIRST — before any other skill in the chain

Try: /swing-clarify Build me an auth system

swing-research

4-stage verified research pipeline with anti-hallucination safeguards.

Deconstruct → Search & Collect → Cross-Verify → Synthesize

Every claim must be traced to a specific, citable source — or labeled Unverified
Source tiering: S (academic/specs), A (official docs), B (community — flagged), C (general)
Cross-verification: key claims require 2+ independent sources (same-origin rewrites don't count)
Adaptive depth: narrow questions get 2-3 queries, broad landscape gets 8+

Try: /swing-research Is gRPC better than REST for mobile backends?

swing-options

Probability-weighted option generator that breaks anchoring bias.

5 options by default, each assigned a typicality zone (Conventional → Wild card)
At least 1 option from the unconventional or wild card zone — ideas your AI normally suppresses
Hidden Assumptions section exposes why the obvious answer seems obvious
Decision matrix with criteria derived from your stated constraints + 1 hidden criterion you didn't consider

Try: /swing-options Which database for a real-time leaderboard?

swing-review

Structured Devil's Advocate that finds real problems, not nitpicks.

Steel-man first: articulates the strongest case FOR the current approach before attacking
3 independent vectors: Logical Soundness / Edge Case Assault / Structural Integrity
Severity classification: Critical (must fix) / Major (should fix) / Minor / Note
Every Critical and Major finding includes a counter-proposal with trade-off analysis
Explicit verdict thresholds: any unmitigated Critical = FAIL

Try: /swing-review We chose Kubernetes for our 3-person startup

swing-trace

Makes AI reasoning visible, auditable, and decomposable.

Assumption inventory: every assumption numbered, rated for criticality and verifiability
Decision tree: at each reasoning fork, what alternative was considered and why it was rejected
Confidence decomposition: overall confidence broken into sub-components with justifications
Weakest link: which single assumption, if wrong, would most change the conclusion
Alternative conclusion: "If [weakest assumption] is wrong, then the answer changes to [X]"

Try: /swing-trace Why do you recommend microservices for this project?

swing-mortem

Prospective failure analysis — assumes your plan failed and works backward.

"It is 6 months from now. This failed completely. What went wrong?"
5 failure scenarios across categories: Technical / Organizational / External / Temporal / Assumption
Likelihood x Impact matrix → focus on top 3 risks
Leading indicators: measurable early-warning signals for each top risk
Circuit breakers: specific trigger conditions for when to stop and pivot

Try: /swing-mortem We're migrating our monolith to microservices over Q3

Which Skill Should I Use?

Daily Use (Flagship)

Your situation	Skill	Example
Request is vague or has implicit assumptions	`swing-clarify`	"Build me an auth system" → clarifies SSO? RBAC? OAuth?
Researching a technology or verifying a claim	`swing-research`	"Is gRPC better than REST for mobile?"
Reviewing code, architecture, or a decision	`swing-review`	"We chose Kubernetes for our 3-person startup"

High-Stakes Moments

Your situation	Skill	Example
Choosing between options	`swing-options`	"Which database for real-time leaderboard?"
Planning a project, want to de-risk	`swing-mortem`	"We're migrating to microservices in Q3"

Deep Analysis

Your situation	Skill	Example
Want to see WHY the AI recommends something	`swing-trace`	"Why microservices for this project?"
Need full audit trail	`swing-trace --full`	Architecture decision records

Recommended Chains

Any Task: swing-clarify → [any other skill] (always clarify first)
Tech Decision: swing-clarify → swing-options → swing-research → swing-review
Architecture Review: swing-trace → swing-review
Project Kickoff: swing-mortem → swing-options (for mitigations)

How They Work Together

Your AI's default reasoning:

  [Question] ──→ [First plausible answer] ──→ [Ship it]


With Swing:

  [Request]
       │
       ├──→ swing-clarify ──→ "What EXACTLY do you need?"  (prevents premature closure)
       │
       ├──→ swing-options ──→ "What are ALL the options?"  (breaks anchoring)
       │
       ├──→ swing-research ──→ "Is this actually true?"  (blocks hallucination)
       │
       ├──→ swing-trace ──→ "WHY do I believe this?"  (exposes assumptions)
       │
       ├──→ swing-review ──→ "What's WRONG with this?"  (kills confirmation bias)
       │
       └──→ swing-mortem ──→ "HOW will this FAIL?"  (counters optimism bias)

Each firewall is independent — use one, or chain them.

Why a Skill?

You could paste these instructions into CLAUDE.md or a system prompt. But:

Context efficiency — Skills load only when triggered (~100 tokens to scan, full instructions only when invoked). A system prompt pays the token cost every message.
Composability — Skills chain: swing-clarify → swing-research → swing-review. A monolithic prompt can't be selectively invoked.
Portability — npx skills add works across Claude Code, Cursor, Copilot. A system prompt is locked to one tool.
Community — Skills can be shared, forked, and improved. A prompt in your dotfiles helps only you.

Install

Quick Install (npx)

npx skills add whynowlab/swing-skills --all

Individual Skills

npx skills add whynowlab/swing-skills@swing-clarify
npx skills add whynowlab/swing-skills@swing-research
npx skills add whynowlab/swing-skills@swing-review
npx skills add whynowlab/swing-skills@swing-options
npx skills add whynowlab/swing-skills@swing-trace
npx skills add whynowlab/swing-skills@swing-mortem

Manual

git clone https://github.com/whynowlab/swing-skills.git
cp -r swing-skills/skills/* ~/.claude/skills/

Per-Project

cp -r swing-skills/skills/swing-review .claude/skills/

Compatibility

Platform	Status
Claude Code	Fully supported
Cursor	Compatible (Agent Skills standard)
GitHub Copilot	Compatible (Agent Skills standard)
Codex CLI	Compatible (Agent Skills standard)

License

MIT License. See LICENSE.

Swing by @thestack_ai — 6 cognitive firewalls for your AI.