
No Workarounds
Pedro Nauck built this to stop you from lying to the compiler. It enforces root-cause fixes by making you answer "why does this problem exist?" before you write any solution. The skill includes gate functions that catch the usual suspects: type assertions to silence errors, eslint-disable comments, empty catch blocks, setTimeout hacks to fix race conditions, and monkey patches. It's organized into seven categories of workarounds with before/after examples for each. Use it when debugging, fixing bugs, or reviewing code where you're tempted to make the red squigglies disappear instead of fixing what's actually broken. Skip it for trivial formatting or docs-only changes.
- skills.sh installs
- 591
- GitHub stars
- 655
- last updated
- Aug 21, 2026
Install
$ npx -y skills add pedronauck/skills --skill no-workarounds --agent claude-codeInstalls into .claude/skills of the current project.
Files
Fix the Source
Use this skill when a proposed repair suppresses a diagnostic or hides a failure instead of correcting it. Start from the evidence already collected; use systematic-debugging only when the cause remains unclear.
- Trace the observed failure to its owning code or boundary. Correct that cause and verify the original symptom in the existing owning suite or probe.
- Review casts, suppressions, swallowed errors, fixed sleeps, monkey patches, and fallback chains in context. These are investigation signals, not proof that every occurrence is wrong. Read the matching entry in
references/workaround-catalog.mdwhen needed. - Preserve intentional boundary validation, typed failure handling, and compatibility migrations/adapters required by project policy. A documented deprecation window is a product contract.
- Keep the repair focused; reuse suitable utilities and avoid unrelated architecture cleanup.
External Defects
Sponsors
Details
- Repository
- github.com/pedronauck/skills
- Categories
- Testing & QA, Documentation, Code Review & Quality, Debugging, Productivity & Planning, Video & Audio Editing
- First seen
- Jun 3, 2026
More from pedronauck/skills
All 70- Typescript Advanced584
- Qa Execution565
- Architectural Analysis553
- Qa Report548
- Tailwindcss481
- React480
- Skill Best Practices476
- Agent Browser471
- Electron Builder449
- Context7439
- Refactoring Analysis432
- Zod421
- Next Best Practices399
- Git Rebase398
- Systematic Debugging392
- Tanstack391
- Shadcn390
- Vitest383
- Zustand367
- Vercel React Best Practices364
- Hormozi Ad Factory363
- Brainstorming356
- A11y Testing355
- Humanizer352