decomp-code-rules

Installation
SKILL.md

decomp-code-rules: source that matches and reads like the original

Files:

  • references/rules.md is the full catalogue, with examples. Read the sections you need.
  • references/style-defaults.md has the naming and layout tables to start from when the original's own style is unknown.
  • The project's AGENTS.md holds the project profile: compiler dialect, naming style, placeholder patterns, evidence sources, commands, and any rule the project tightens or relaxes. The project profile overrides this skill.

Why: the reader test

A decompilation exists so people can understand the original program. Matching bytes prove the source is faithful; readable source is the point. Every rule serves one test:

Would a programmer on the original team, writing in that codebase's style and dialect, have typed this? And can a reader see what it does, and why, without opening the disassembly?

Installs
5
GitHub Stars
197
First Seen
Oct 26, 2026