# Poka yoke

> Poka yoke is an open-source agent skill. Mistake-proof code so misuse cannot be expressed, rather than warning against it. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/github/awesome-copilot/tree/main/skills/poka-yoke
- **Repository:** https://github.com/github/awesome-copilot
- **GitHub stars:** 41,254
- **License:** MIT
- **Skill name:** poka-yoke
- **Collection:** https://github.com/github/awesome-copilot
- **Listing updated:** 2026-11-17

## About

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.

## 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.

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Runs Python scripts](https://github.com/github/awesome-copilot/tree/HEAD/skills/poka-yoke)
- [No network calls found in its scripts](https://github.com/github/awesome-copilot/tree/HEAD/skills/poka-yoke)
- [License: MIT](https://github.com/github/awesome-copilot/tree/HEAD/skills/poka-yoke)

## Install

### Claude Code

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

```sh
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.

### Codex

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

```sh
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.

### Cursor

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

```sh
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.

### Gemini CLI

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

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

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

### VS Code

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

```sh
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.

### Other agents

Get the folder:

```sh
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.

## 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.

---
Source: https://ai-powered.com/skills/poka-yoke
