poka-yoke SKILL.md skillA

poka-yoke from kuya-egg/monozukuri is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kuya-egg/monozukuri/poka-yoke@git:20260909.6197cfc

Pins git:20260909.6197cfc in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kuya-egg/monozukuri
Path
poka-yoke/SKILL.md
Versions recorded
1
Latest version
git:20260909.6197cfc, committed Sep 9, 2026
Size
3,854 bytes
Repository stars
16
License
MIT

Prevent software mistakes through strong boundaries, safe defaults, meaningful tests, and mechanically enforced invariants. Use for TDD, validation, schemas, authorization, edge cases, regression coverage, or reliability-sensitive behavior.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Poka-yoke

Poka-yoke means mistake-proofing. In software, do not rely only on memory or
discipline when types, schemas, constraints, validation, tests, or safe
defaults can prevent an invalid state. This is a Japanese-inspired engineering
metaphor, applied with context rather than maximal defensive code.

## Use this skill when

- adding or changing behavior at an input, API, database, or permission
  boundary;
- designing tests or working test-first;
- fixing a regression or recurring failure;
- handling untrusted data, retries, concurrency, migrations, or external
  services;
- deciding whether a bad state should be representable; or
- reliability and safety matter more than a happy-path demo.

## Outcome

Produce a behavior that is difficult to misuse and easy to verify, with:

- explicit invariants and boundary conditions;
- validation at the correct boundary;
- types, schemas, constraints, or exhaustive cases where they reduce risk;
- deterministic tests for normal, edge, failure, and authorization behavior;
- safe defaults, idempotency, and clear error handling where relevant; and
- evidence that the protection catches the intended mistake.

## Workflow
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kuya-egg/monozukuri/poka-yoke@sha256:023944b4f1640209

The line at the top of this page pins the label git:20260909.6197cfc, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jpgsfhnsoz3rw544.svg)](https://markdownregistry.com/a/art_jpgsfhnsoz3rw544)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 9, 2026.

versioncommittedcommitsizeaudit
git:20260909.6197cfc latest2026-09-09 6197cfc 3,854 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3854 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kuya-egg/monozukuri · 16 stars · license MIT · pushed 2026-09-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jpgsfhnsoz3rw544
GET https://markdownregistry.com/api/v1/resolve?ref=kuya-egg/monozukuri/poka-yoke
GET https://markdownregistry.com/api/v1/blob/023944b4f164020905a83da810df5911ce6cba4a6abb97bb1960a198d513322c

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kuya-egg/monozukuri

andon SKILL.md skill
kuya-egg/monozukuri · andon/SKILL.md · Make software health, failure, degradation, and recovery visible through useful observability and diagnostics. Use when…
git:20260909.6197cfc · audit A · 16 stars
genchi-genbutsu SKILL.md skill
kuya-egg/monozukuri · genchi-genbutsu/SKILL.md · Inspect the real repository, environment, dependencies, and runtime evidence before designing or changing software. Use…
git:20260909.6197cfc · audit A · 16 stars
hansei SKILL.md skill
kuya-egg/monozukuri · hansei/SKILL.md · Reflect on failures, incidents, reviews, and completed software work to turn evidence into durable tests, guardrails…
git:20260909.6197cfc · audit A · 16 stars
jidoka SKILL.md skill
kuya-egg/monozukuri · jidoka/SKILL.md · Debug software by making failures visible, reproducing them, finding contributing causes, and adding durable regression…
git:20260909.6197cfc · audit A · 16 stars
kaizen SKILL.md skill
kuya-egg/monozukuri · kaizen/SKILL.md · Improve software continuously through small, safe, behavior-preserving changes that reduce maintenance cost. Use for…
git:20260909.6197cfc · audit A · 16 stars
kanso SKILL.md skill
kuya-egg/monozukuri · kanso/SKILL.md · Choose simple, maintainable software designs by removing speculative complexity, comparing alternatives, and making…
git:20260909.6197cfc · audit A · 16 stars
kata SKILL.md skill
kuya-egg/monozukuri · kata/SKILL.md · Implement software through small, repeatable, integrated vertical slices with clear exit criteria and honest…
git:20260928.56a849e · audit A · 16 stars
kodawari SKILL.md skill
kuya-egg/monozukuri · kodawari/SKILL.md · Review software with careful attention to correctness, maintainability, security, operations, and meaningful detail…
git:20260909.6197cfc · audit A · 16 stars
monozukuri-blueprint SKILL.md skill
kuya-egg/monozukuri · monozukuri-blueprint/SKILL.md · Author a greenfield build blueprint in four gated stages — business logic, tech stack, logic-to-stack mapping, and a…
git:20260928.fe2f1d7 · audit A · 16 stars
monozukuri-core SKILL.md skill
kuya-egg/monozukuri · monozukuri-core/SKILL.md · The one Monozukuri command: routes the task, runs the greenfield blueprint when needed, drives the focused skills…
git:20260928.fe2f1d7 · audit A · 16 stars
monozukuri-router SKILL.md skill
kuya-egg/monozukuri · monozukuri-router/SKILL.md · Step 0 of consequential software work under Monozukuri, run by monozukuri-core. Classify the task, assess its risk…
git:20260928.fe2f1d7 · audit A · 16 stars
nemawashi SKILL.md skill
kuya-egg/monozukuri · nemawashi/SKILL.md · Clarify software goals, constraints, stakeholders, and risks before consequential design or implementation work. Use…
git:20260909.6197cfc · audit A · 16 stars

Every file in kuya-egg/monozukuri

Browse by kind, by grade A, or by owner.