What problem does it solve?
This Skill helps prevent costly software and operational mistakes by redesigning APIs, CLIs, configs, and workflows so unsafe actions cannot be expressed or are rejected immediately. It is especially useful when teams keep relying on training, warnings, or after-the-fact detection instead of building safety into the system itself.
Core Features & Use Cases
- Prevention-first design: Moves defects up the ladder from production incidents to structural impossibility using types, schemas, state machines, and safer defaults.
- Poka-yoke method selection: Applies contact, fixed-value, and motion-step methods to issues like invalid inputs, skipped steps, dangerous flag combinations, and destructive defaults.
- Andon and failure design: Defines loud, visible stop-the-line behavior when prevention is not fully possible.
- Use cases: Review a deployment CLI that makes production changes too easy, redesign a config format so invalid states cannot load, or audit a repeated operator workflow after an incident caused by human error.
Quick Start
Use the mistake-proofing skill to audit a risky API, CLI, config, or runbook and propose design changes that make the most dangerous mistakes impossible or immediately rejected.