clean-debug
Diagnose bugs and failing behavior with causal-chain discipline before fixing.
Skill by shashank-sn
Chalk Labs
Need help deploying clean-debug?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/shashank-sn-clean-debug
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
Network hosts it talks to 1
codeload.github.com· found in install command
Files it touches
~/.claude/skills/clean-debug
What's inside
- Skill name
clean-debug- Description
- Diagnose bugs and failing behavior with causal-chain discipline before fixing. Use for errors, regressions, failed tests, or stuck investigations after a bad fix.
- License
- MIT
- Instructions
- 24 lines in SKILL.md · view on GitHub
Files (3)
- SKILL.md
- agent.json
- openai.yaml · agents/
SKILL.md (first lines)
# Clean Debug Investigate systematically, explain the full causal chain, then fix with test-first discipline. ## Workflow 1. Parse the failure: stack trace, test path, issue reference, or reproduction steps. 2. Reproduce the bug. Trace the code path from trigger to symptom without gaps. 3. Form hypotheses. For uncertain links, make predictions testable in another scenario. 4. Stop at the causal chain gate: do not fix until the chain is complete or labeled as symptom-only with evidence. 5. If fixing: run or add a failing test first, apply one change, rerun affected checks through `clean-verify` when configured. 6. Hand evidence to `clean-review` when the fix touches behavior-bearing code. ## Modes - **Interactive (default):** ask whether to fix after diagnosis when appropriate. - **Pipeline (`mode:pipeline`):** fix convergent root causes, defer divergent issues, return structured status. ## Safety - One hypothesis change at a time. No shotgun debugging. - Never treat passing tests alone as proof when mutation or acceptance gaps remain.
From shashank-sn/clean-code, MIT.
More from shashank-sn/clean-code
- 0.523score
clean-learn
shashank-sn
Turn confirmed defects, false positives, accepted changes, review outcomes, and benchmark results into reversible policy, threshold, adapter, convention, or…
SkillBFreshness: BClaude Code +9 - 0.523score
clean-lfg
shashank-sn
Run the full autonomous shipping pipeline from planning through implementation, simplification, dead-code pruning, final verification, review, ship, and CI…
SkillBFreshness: BClaude Code +9 - 0.523score
clean-merge-resolver
shashank-sn
Resolve an in-progress git merge or rebase conflict hunk by hunk, tracing each resolution to both sides' primary sources, then finish the operation.
SkillBFreshness: BClaude Code +9 - 0.523score
clean-orchestrate
shashank-sn
Coordinate specification, implementation, independent testing, deterministic verification, review, human spot checks, and audit without treating agent…
SkillBFreshness: BClaude Code +9 - 0.523score
clean-build
shashank-sn
Implement one bounded behavior through short, verified steps while protecting requirements, architecture policy, repository conventions, and unrelated code.
SkillBFreshness: BClaude Code +9 - 0.523score
clean-review
shashank-sn
Review code, requirements, architecture, tests, and deterministic evidence with concrete findings, structural simplification, and permission to return zero…
SkillBFreshness: BClaude Code +9 - 0.523score
clean-design
shashank-sn
Turn requirements into use cases, stable policy boundaries, delivery and data boundaries, dependency direction, acceptance examples, and repository-owned…
SkillBFreshness: BClaude Code +9 - 0.523score
clean-refactor
shashank-sn
Improve names, functions, duplication, responsibility placement, dependency direction, boundaries, and module structure through behavior-preserving changes.
SkillBFreshness: BClaude Code +9 - 0.523score
clean-eval-discover
shashank-sn
Turn real work outcomes and bounded human judgment into representative, reviewable evaluation candidates.
SkillBFreshness: BClaude Code +9 - 0.523score
clean-audit
shashank-sn
Produce an immutable, revision-bound release receipt from deterministic verification, independent test planning, review, human spot checks, policy identity…
SkillBFreshness: BClaude Code +9 - 0.520score
clean-dispatcher
shashank-sn
Dispatch implementation, test-writing, review, and audit to their dedicated sub-agents with bounded ownership and isolated contexts, preserving…
SkillBFreshness: BClaude Code +9 - 0.520score
clean-auditor
shashank-sn
Produce the immutable release receipt mapping requirements to evidence, decoupled from implementers so it cannot self-whitewash.
SkillBFreshness: BClaude Code +9
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Last commit (this folder)
- Aug 21, 2026 (2 months ago)
- Last release
- Sep 17, 2026 (1 month ago)
From GitHub (fetched Oct 24, 2026).
Details
- License
- MIT
- Repository
- github.com/shashank-sn/clean-code
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
More from shashank-sn
- 0.607score
hyv-prepare-rebuild
shashank-sn
Prepare a rebuild task only after an upstream REBUILD recommendation, a CopySpec, and a signed rebuild-authorization capability.
SkillBFreshness: B★ 32Claude Code +9 - 0.604score
hyv-apply-hidden-text-policy
shashank-sn
Apply only explicitly approved minimal hidden-text removals and return hashes, exact changes, and remaining findings.
SkillBFreshness: B★ 32Claude Code +9 - 0.604score
hyv-learning
shashank-sn
Inspect or explicitly mutate text-free local learning state for a profile.
SkillBFreshness: B★ 32Claude Code +9 - 0.604score
hyv-analyze
shashank-sn
Run separate VoiceDNA and AI Editor checks plus a non-scoring Unicode hygiene inspection against a draft.
SkillBFreshness: B★ 32Claude Code +9 - 0.604score
hyv-logic-lint
shashank-sn
Run the deterministic document-coherence gate for topic drift, unanchored inference, and internal contradictions.
SkillBFreshness: B★ 32Claude Code +9 - 0.604score
hold-your-voice
shashank-sn
Review or revise user-provided writing while protecting its stated meaning, constraints, and voice.
SkillBFreshness: B★ 32Claude Code +9
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get clean-debug running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
clean-debug skill. Agent Mart. https://agentmart.dev/skills/shashank-sn-clean-debug (last updated 2026-10-24)