mistake-proofing

Redesign software interfaces and workflows to prevent human and system errors.

2|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/NlightNFotis/skills --skill mistake-proofing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mistake-proofing
Source: https://github.com/NlightNFotis/skills/tree/main/mistake-proofing
Command: npx skills add https://github.com/NlightNFotis/skills --skill mistake-proofing

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about mistake-proofing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent invalid states and dangerous flag combinations in API design?

To prevent invalid states in API design, you apply poka-yoke methods using strict types, schemas, and state machines so unsafe actions cannot be expressed or are rejected immediately at the boundary. This moves defects from production incidents to structural impossibility.

What is the best way to make destructive CLI actions impossible by design?

Making destructive CLI actions impossible by design involves auditing flag combinations and implementing safer defaults. You redesign the CLI workflow using fixed-value and motion-step poka-yoke methods to prevent dangerous commands from executing.

How do I stop repeated operator mistakes during deployment workflows and migrations?

You stop repeated operator mistakes by redesigning deployment workflows and migrations so skipped steps or invalid inputs are structurally blocked. Applying contact and motion-step poka-yoke methods ensures unsafe actions are rejected immediately at the boundary.

When should I use error prevention versus after-the-fact detection in software engineering?

Error prevention should be used over after-the-fact detection when teams repeatedly rely on training or warnings instead of building safety into the system. Prevention-first design uses schemas and safer defaults to make invalid states unrepresentable, moving defects up the ladder from incidents to structural impossibility.

What happens when you cannot fully prevent dangerous actions in a configuration schema?

When you cannot fully prevent dangerous actions in a configuration schema, you design andon failure behavior. This defines loud, visible stop-the-line mechanisms that halt the process immediately, ensuring residual risks are caught instead of silently causing incidents.