skills.rest
itsgrimetime
itsgrimetimeCOMMUNITY
Explore all skills by this author →
GitHub

decomp-permuter

Automate C code permutation to match target assembly in decompilation workflows.

6|Updated Dec 26, 2025
Search Tags:#decompilation#scratch-workflow#assembly-matching#code-permutation#pycparser#nonmatchings
One-click install
npx skills add https://github.com/itsgrimetime/melee-decomp --skill decomp-permuter
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: decomp-permuter
Source: https://github.com/itsgrimetime/melee-decomp/tree/main/.claude/skills/decomp-permuter
Command: npx skills add https://github.com/itsgrimetime/melee-decomp --skill decomp-permuter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Stuck at high assembly-code match (e.g., 95%+) during decompilation, this tool automatically searches thousands of C code variations to produce a perfect or near-perfect match for a target function.

Core Features & Use Cases

  • Automatic permutation of candidate C code to reduce mismatches against assembly outputs.
  • Supports creating a minimal base.c, extracting target.s, and running the permuter against nonmatchings to converge on a precise match.
  • Provides iterative improvement with output diffs and scoring to guide integration into scratches and repro workflows.

Quick Start

Create a minimal base.c, prepare target.s from the build, and run the permuter to search for improved matches.

Frequently Asked Questions about decomp-permuter

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

FAQPage Schema
How do I automatically match C code to target assembly during decompilation?▼

Automated code permutation searches thousands of C code variations to match target assembly during decompilation. It scores and iteratively reduces mismatches against target.s outputs to converge on a perfect or near-perfect match.

Why is my decompilation stuck at 95% assembly match and how do I fix it?▼

Code permutation resolves high assembly match plateaus by automatically testing thousands of C code variations against target assembly. It generates output diffs and scoring to guide integration into scratches and repro workflows.

What do I need to set up before running code permutation for nonmatchings?▼

Code permutation requires a minimal base.c file, a prepared target.s extracted from the build, the decomp-permuter tool, Python dependencies, permuter_settings.toml, and toolchains like devkitPPC for assembly and object generation.

How does automated code permutation work with the melee-decomp project workflow?▼

Code permutation integrates with melee-decomp workflows by preparing a minimal base.c, assembling a target.s, and running the permuter against nonmatchings to converge on a precise assembly match.

Can I use the decomp-permuter without devkitPPC for assembly and object generation?▼

No, code permutation requires proper toolchains like devkitPPC for assembly and object generation, alongside Python dependencies and permuter_settings.toml, to function correctly.

What are the limitations of automated C code permutation for matching assembly?▼

Code permutation is most effective when stuck at high assembly match percentages like 95% or above, requiring a minimal base.c and target.s. It may not converge without proper toolchains like devkitPPC and correct settings.

Related Skills

Explore More Software Engineering Skills→
qianleigoodqianleigood
30

minimax-pdf

Automate PDF creation, form filling, and reformatting with Python scripts.

Community
Advanced
itsgrimetimeitsgrimetime
6

decomp

Match decompiled C code to original PowerPC assembly for Melee.

Community
Advanced
itsgrimetimeitsgrimetime
6

decomp-fixup

Diagnose and fix header mismatches in matched Melee decomp functions.

Community
Intermediate
cdlewiscdlewis
178

match-data-file

Update YAML data entries and C source mappings during ROM decompilation.

Community
Intermediate