Stop Guessing — Development skill for Claude Code
Debugging discipline for coding agents: reproduce, localize, evidence, minimal fix, verify.
How to install Stop Guessing
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open cv-superding/stop-guessing and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Stop Guessing does
Debugging discipline for coding agents: reproduce, localize, evidence, minimal fix, verify. Never edit code to see if it helps.
Alternatives in Development
- Claude SEO — Multi-Platform Agent Instructions — For Cursor, Cursor Cloud Agents, Google Antigravity, and Gemini CLI 5k ★
- Discipline — Toggle discipline mode — auto-invoke verification, brainstorming-before-coding, and review checks 2.8k ★
- Clear Code — See your claude code logs in clear details in your dashboard 2.1k ★
README
English · 简体中文
你的 agent 从来不读报错信息。这个技能让它读。
一个给编程 agent 用的调试纪律技能,用固定流程替换 **"大概是 X 吧,我改一下试试"**:复现 → 定位 → 证据 → 最小修复 → 验证。加载这个技能后,agent 不能再把一个猜的修法叠在另一个猜的修法上面——必须先给你看证据。
兼容所有支持 [Agent Skills](https://agentskills.io) 的 agent:Claude Code、Codex CLI、Cursor、Gemini CLI、OpenCode 等。
纪律,画成一张图
上图由 [Archify](https://github.com/tt-a1i/archify) 生成——在浏览器中打开 [`docs/stop-guessing-diagram.html`](docs/stop-guessing-diagram.html) 可查看交互版(缩放、路径追踪、暗色主题)。
问题
让 agent 修一个 bug,通常会看到这样的对话:
**Agent:** 啊,这大概是因为环境变量没加载。*(加了 `dotenv.config()`)* 我再顺手加个空值检查以防万一。*(又改了一处)* 现在应该可以了。
没有复现、没有证据、两次修改之间什么都没运行
Related Skills
Accuracy Verify Claims
Accuracy-scout step 3 — run minimal examples to reproduce issue claims (if applicable)
GPU
Diagnose GPU health, discover bounded recipes, and collect typed numeric evidence without guessing from screen
Indigo Riso Poster Skill
Claude Code / Codex skill: turn a theme word into an indigo-and-cream duotone riso-print poster. Halftone dots
Pair Verify
Use after you fix a bug and before you claim it fixed — it spawns ONE skeptic sibling session via CCC that mus
Phaser Feedback
Triage pasted player feedback, reproduce it, fix it, and verify
Videodb Skills
See, understand, and act on video & audio — ingest, search, edit, generate, and stream media via VideoDB.
Related Agents
Part 19: Repowise — Codebase Intelligence For Coding Agents
60% fewer tokens. 4x faster. Your coding agents stop guessing and start knowing. ---
Bug Fix
Use when diagnosing and fixing a bug. Chains reproduce → isolate → hypothesize → fix → verify → learn with hum
Engineering Minimal Change Engineer
Engineering specialist focused on minimum-viable diffs — fixes only what was asked, refuses scope creep, prefe