Skip to content

meltedinhex/analyst-ai-pack / skills/unpacking-upx-and-common-packers

unpacking-upx-and-common-packers

Verified

Identifies and unpacks packed binaries: detecting packers from section names and entropy, automatically unpacking UPX, and manually unpacking custom packers by finding the OEP and dumping. Activates for requests to unpack a packed sample, detect a packer, or recover the original binary from UPX or a custom packer.

FileKindSize
LICENSEother340 B
SKILL.mdskill md3.1 KB
references/api-reference.mdmarkdown1.2 KB
scripts/analyst.pyscript3.0 KB

references/api-reference.md

View on GitHub
# API Reference: Unpacking UPX and Common Packers

## Overview

`scripts/analyst.py` detects common packers from PE section names and per-section entropy and
recommends an unpacking approach (automated UPX vs manual debugger unpacking). It parses the
PE section table directly and reads bytes only.

## Dependencies

| Package | Version | Purpose |
|---------|---------|---------|
| (stdlib) | — | struct, entropy |

## External tools

| Tool | Purpose |
|------|---------|
| upx | Automated pack/unpack for standard UPX |
| Detect It Easy (DIE) | Broad packer/compiler signature detection |
| x64dbg + Scylla | Manual unpacking, dumping, IAT rebuild |

## Core functions

### `detect(path)`
Returns packer signatures, sections with entropy, high-entropy sections, whole-file entropy,
a `likely_packed` flag, and an unpacking recommendation.

### `parse_sections(data)`
Minimal PE section-table parser (name, raw size, entropy).

## Usage

```bash
python scripts/analyst.py detect sample.bin
upx -d -o sample_unpacked.bin sample.bin     # if standard UPX
```

## Sources

- UPX — https://upx.github.io/
- Detect It Easy — https://github.com/horsicq/Detect-It-Easy
- Common packer section-name conventions (DIE/PEiD signature knowledge)
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall