Amiga XPK/NUKE Decompressor
mbackschat/amiga-xpk-decompress-skill
Descompacta arquivos Amiga XPK/NUKE e DUKE em lote com segurança
Ver no GitHubSkill para Claude Code que descompacta arquivos Amiga comprimidos com XPK/NUKE e XPK/DUKE. Processa arquivos individuais ou árvores de diretórios recursivamente, com validação de header e checksum antes de qualquer escrita.
Instalação
npx convez-ai mbackschat/amiga-xpk-decompress-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Recuperar arquivos de software Amiga legado comprimido
- Processar lotes de arquivos XPK/NUKE em pipelines de arquivamento
- Validar integridade de arquivos comprimidos antes de restauração
Veredito

Ferramenta especializada e bem-implementada para um nicho específico (retrocomputação Amiga). Código robusto com validação de header e suporte tanto ao Claude Code quanto ao uso standalone, mas audiência limitada.
README
A tradução para o português deste README ainda está na fila.
Amiga XPK/NUKE Decompressor — Claude Code Skill
A Claude Code skill that decompresses Amiga XPK-compressed files using the NUKE and DUKE sub-packers.
Point it at a file or an entire directory tree and it will find and unpack every XPK/NUKE (or DUKE) compressed file, skipping everything else.
What it does
| Feature | Detail |
|---|---|
| Formats | XPK/NUKE (LZ77 variant) and XPK/DUKE (NUKE + delta encoding) |
| Scope | Single files, directories, or recursive directory trees |
| Safety | Header magic, checksum, and preview verification before any write |
| Dependencies | Python 3 + uv — no pip installs needed |
Installation
Copy the skill folder into your Claude Code skills directory:
# Clone the repo
git clone https://github.com/mbackschat/amiga-xpk-decompress-skill.git
# Copy the skill into place
cp -r amiga-xpk-decompress-skill/.claude/skills/xpk-decompress ~/.claude/skills/
Or, if you prefer a one-liner:
git clone https://github.com/mbackschat/amiga-xpk-decompress-skill.git /tmp/xpk-skill \
&& mkdir -p ~/.claude/skills \
&& cp -r /tmp/xpk-skill/.claude/skills/xpk-decompress ~/.claude/skills/ \
&& rm -rf /tmp/xpk-skill
After installation, restart Claude Code. The /xpk-decompress slash command will be available.
Usage
Inside Claude Code, use the skill as a slash command:
/xpk-decompress /path/to/compressed/files -o /path/to/output
Examples
Decompress a single file:
/xpk-decompress game.lha.nuke -o ./unpacked/
Decompress an entire directory recursively (in place):
/xpk-decompress /home/user/amiga-sources/
Dry run — list compressed files without writing:
/xpk-decompress /path/to/directory --dry-run
Flags
| Flag | Description |
|---|---|
-o, --output | Output directory (default: decompress in place, overwriting originals) |
-n, --dry-run | List matching files without decompressing |
--no-recursive | Don't recurse into subdirectories |
How it works
The decompressor is a pure-Python port of the NUKE/DUKE codec from ancient by Teemu Suutari (ISC license).
- Header validation — checks the
XPKFmagic, verifies the packer ID isNUKEorDUKE, and confirms the XOR checksum across bytes 0–35 is zero. - Chunk iteration — walks the XPK chunk stream, handling stored (type 0) and compressed (type 1) chunks until the end marker (type 15).
- NUKE decompression — each compressed chunk is decoded using interleaved forward/backward byte streams, MSB and LSB bit readers, and a variable-length code table for LZ77 distances.
- DUKE delta decode — if the packer is DUKE, an additional delta-decoding pass is applied to the output.
- Preview verification — the first 16 bytes of the decompressed output are compared against the header's preview field.
Non-XPK files are silently skipped, so it is safe to point the tool at a mixed directory.
Standalone usage
The Python script can also be used directly without Claude Code:
uv run python3 .claude/skills/xpk-decompress/xpk_nuke_decompress.py /path/to/files -o /output
Or with plain Python:
python3 .claude/skills/xpk-decompress/xpk_nuke_decompress.py /path/to/files -o /output
License
MIT — see LICENSE.
The NUKE/DUKE decompression algorithm is ported from ancient (ISC license) by Teemu Suutari.