convez.ai
SkillUtilidadesAvançado
mbackschat

Amiga XPK/NUKE Decompressor

mbackschat/amiga-xpk-decompress-skill

Descompacta arquivos Amiga XPK/NUKE e DUKE em lote com segurança

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-skill

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

FeatureDetail
FormatsXPK/NUKE (LZ77 variant) and XPK/DUKE (NUKE + delta encoding)
ScopeSingle files, directories, or recursive directory trees
SafetyHeader magic, checksum, and preview verification before any write
DependenciesPython 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

FlagDescription
-o, --outputOutput directory (default: decompress in place, overwriting originals)
-n, --dry-runList matching files without decompressing
--no-recursiveDon'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).

  1. Header validation — checks the XPKF magic, verifies the packer ID is NUKE or DUKE, and confirms the XOR checksum across bytes 0–35 is zero.
  2. Chunk iteration — walks the XPK chunk stream, handling stored (type 0) and compressed (type 1) chunks until the end marker (type 15).
  3. 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.
  4. DUKE delta decode — if the packer is DUKE, an additional delta-decoding pass is applied to the output.
  5. 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.

Ver o original no GitHub

Bom para

Relacionados