Skip to content
Skill

Poka yoke

Mistake-proof code so misuse cannot be expressed, rather than warning against it

Install
Scripts
Python
Platforms
Claude Code, Codex, Cursor
GitHub stars
41.3K
Last commit
1 day ago
License
MIT
Listing updated
today

When your agent uses it

Mistake-proof code so misuse cannot be expressed, rather than warning against it. Use when designing an interface, schema, or state machine and the user wants it hard to get wrong ("make invalid states unrepresentable", "so callers cannot screw it up", "type-safe API", "pit of success"); when auditing existing code for footguns ("what could bite us here", "what is easy to misuse", "poka-yoke this repo", "review this diff for ways to get it wrong"); or when a bug has recurred and the fix must close the class rather than the case ("make sure this never happens again", "this is the third time"). Especially for money, auth, permissions, deletion, migrations, and pipelines where failure is silent. Classifies every finding by what happens when the mistake occurs and how the device notices, which is what keeps it from collapsing into generic code review.

From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.

What it can access

From a static check of its 6 files (78 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.

Install

Copy the skill folder to ~/.claude/skills/poka-yoke to use it in all your projects:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/poka-yoke &&
cp -R "$tmp/skills/poka-yoke" ~/.claude/skills/poka-yoke &&
rm -rf "$tmp"

For one project only, put the folder in .claude/skills/poka-yoke inside it instead.

Claude Code docs on skills

Copy the skill folder to ~/.agents/skills/poka-yoke to use it in every repository:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/poka-yoke &&
cp -R "$tmp/skills/poka-yoke" ~/.agents/skills/poka-yoke &&
rm -rf "$tmp"

For one repository only, put the folder in .agents/skills/poka-yoke inside it instead.

Codex docs on skills

Copy the skill folder to ~/.cursor/skills/poka-yoke to use it in every project:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/poka-yoke &&
cp -R "$tmp/skills/poka-yoke" ~/.cursor/skills/poka-yoke &&
rm -rf "$tmp"

For one project only, put the folder in .cursor/skills/poka-yoke inside it instead.

Cursor docs on skills

Run in a terminal (add --scope workspace to install it for the current workspace only):

gemini skills install https://github.com/github/awesome-copilot.git --path skills/poka-yoke

Or copy the folder to ~/.gemini/skills/poka-yoke yourself.

Gemini CLI docs on skills

For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/poka-yoke:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/poka-yoke &&
cp -R "$tmp/skills/poka-yoke" ~/.copilot/skills/poka-yoke &&
rm -rf "$tmp"

For one project only, put the folder in .github/skills/poka-yoke inside it instead.

VS Code docs on skills

Get the folder:

git clone --depth 1 https://github.com/github/awesome-copilot.git

Then copy awesome-copilot/skills/poka-yoke into your agent's skills folder as poka-yoke. Agents that support SKILL.md read one folder per skill.

The SKILL.md format

Poka yoke FAQ

How do I install Poka yoke in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/poka-yoke to use it in all your projects, or to .claude/skills/poka-yoke in one project.

Does Poka yoke run scripts?

Yes. It runs Python scripts. No network calls were found in its scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

Which AI agents can use Poka yoke?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

More from github/awesome-copilot

  1. Route gh-aw workflow design/create/debug/upgrade requests to the right prompts.

    • Open source
    • 41.3K GitHub stars
  2. Review pull requests for repository fit, meaningful value, trustworthy provenance, differentiation, and maintainability in awesome-copilot.

    • Open source
    • 41.3K GitHub stars
    • Developer tools
  3. Create or register a canvas extension in the awesome-copilot repository

    • Open source
    • 41.3K GitHub stars
  4. Use this skill when the user explicitly asks to map, document, or onboard into an existing codebase

    • Open source
    • 41.3K GitHub stars
  5. Run the AgentRC readiness assessment on the current repository and produce a static HTML dashboard at reports/index.html

    • Open source
    • 41.3K GitHub stars
    • Developer tools