pedronauck avatar

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-code

Installs 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.md when 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
1bobmatnyc avatarfastifybobmatnyc/claude-mpm-skillsProduction Fastify (TypeScript) patterns: schema validation, plugins, typed routes, error handling, security hardening, logging, testing with inject, and gracef590skills.sh installs
2rshankras avatarproduct-developmentrshankras/claude-code-apple-skillsEnd-to-end product development for iOS/macOS apps. Covers market research, competitive analysis, PRD generation, architecture specs, UX design, implementation g583skills.sh installs
3mohitmishra786 avatarzig-build-systemmohitmishra786/low-level-dev-skillsZig build system skill for multi-file Zig projects. Use when writing or debugging build.zig files, adding executables or libraries, integrating C source files, 576skills.sh installs
4jshchnz avatarschedulerjshchnz/claude-code-schedulerSchedules Claude Code tasks to run automatically at specific times using native OS schedulers (launchd on macOS, crontab on Linux, Task Scheduler on Windows). H574skills.sh installs
5yoanbernabeu avatarsupabase-audit-rpcyoanbernabeu/supabase-pentest-skillsList and test exposed PostgreSQL RPC functions for security issues and potential RLS bypass.573skills.sh installs
6alirezarezvani avatarstatistical-analystalirezarezvani/claude-skillsRun hypothesis tests, analyze A/B experiment results, calculate sample sizes, and interpret statistical significance with effect sizes. Use when you need to val572skills.sh installs