# matcher

matcher is a Claude Code skill that reconstructs C/C++ source to match a retail binary. It helps investigate lost matches, recover types and examine code differences.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 231 repo stars
- Author: lemiur
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lemiur/Game-Decompilation-Skill-For-Claude/tree/HEAD/.claude/skills/matcher/SKILL.md
- Updated: 2026-11-01
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/matcher

## What it does

matcher guides reconstruction of C/C++ source that accounts for the bytes in a retail binary. It gathers evidence before edits, including assembly differences, operands, relocations, callers and class information. Then it runs a focused loop: change one hypothesis, execute `match <unit>`, and compare from the first actual divergence.

Project guidance comes from `AGENTS.md`. If that file is missing, the skill points to `AGENTS-template.md`, which needs a project adapter filled in. A byte match must also pass `decomp-code-rules` and the reader test; artificial locals and casts used to force a match do not count as a valid result. The work requires the retail binary and the original compiler.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add lemiur/Game-Decompilation-Skill-For-Claude --skill matcher -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/matcher/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/matcher/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add lemiur/Game-Decompilation-Skill-For-Claude --skill matcher -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/matcher/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add lemiur/Game-Decompilation-Skill-For-Claude --skill matcher -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/matcher/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install lemiur/Game-Decompilation-Skill-For-Claude .claude/skills/matcher
```

2. **Manually: put the files in place**
- File: `.github/skills/matcher/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add lemiur/Game-Decompilation-Skill-For-Claude --skill matcher -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/lemiur/Game-Decompilation-Skill-For-Claude --path .claude/skills/matcher
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/matcher/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/lemiur/Game-Decompilation-Skill-For-Claude/tree/HEAD/.claude/skills/matcher/SKILL.md

## When to use it
- recover a function whose match was lost
- compare C/C++ source against a retail binary
- trace differences in relocations and calls
- recover a class type, vtable or calling convention

## Example prompts
- Recover the source for a function that no longer matches the retail binary.
- Compare `unit` with the binary and find the first real divergence.
- Investigate the matching plateau and test whether a type or relocation is wrong.

## Similar
- [dart-matcher-best-practices](https://affpapa.org/en/nevibecode/skills/dart-matcher-best-practices.md) — skill · 269 installs
- [vibe-matcher](https://affpapa.org/en/nevibecode/skills/vibe-matcher.md) — skill · 194 installs
- [carbon-factor-matcher](https://affpapa.org/en/nevibecode/mcp/carbon-factor-matcher.md) — MCP server · 3609 installs
- [cwicr-quantity-matcher](https://affpapa.org/en/nevibecode/skills/cwicr-quantity-matcher.md) — skill · 125 installs
- [resume-to-jobdescription-matcher](https://affpapa.org/en/nevibecode/mcp/resume-to-jobdescription-matcher.md) — MCP server · 119 installs
- [pattern-matcher](https://affpapa.org/en/nevibecode/agents/pattern-matcher.md) — subagent · ★ 850 repo stars

From the same set: [lemiur/game-decompilation-skill-for-claude](https://affpapa.org/en/nevibecode/by/lemiur/game-decompilation-skill-for-claude.md) — 7 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
