repomix-unmixer

Repomix Unmixer

Overview

This skill extracts files from repomix-packed repositories and restores their original directory structure. Repomix packs entire repositories into single AI-friendly files (XML, Markdown, or JSON), and this skill reverses that process to restore individual files.

When to Use This Skill

This skill activates when:

• Unmixing a repomix output file (*.xml, *.md, *.json)
• Extracting files from a packed repository
• Restoring original directory structure from repomix format
• Reviewing or validating repomix-packed content
• Converting repomix output back to usable files

Core Workflow

Standard Unmixing Process

Extract all files from a repomix file and restore the original directory structure using the bundled unmix_repomix.py script:

python3 scripts/unmix_repomix.py \
  "<path_to_repomix_file>" \
  "<output_directory>"

Parameters:

• <path_to_repomix_file>: Path to the repomix output file (XML, Markdown, or JSON)
• <output_directory>: Directory where files will be extracted (will be created if doesn't exist)

Example:

python3 scripts/unmix_repomix.py \
  "/path/to/repomix-output.xml" \
  "/tmp/extracted-files"

What the Script Does

1. Parses the repomix file format (XML, Markdown, or JSON)
2. Extracts each file path and content
3. Creates the original directory structure
4. Writes each file to its original location
5. Reports extraction progress and statistics

Output

The script will:

• Create all necessary parent directories
• Extract all files maintaining their paths
• Print extraction progress for each file
• Display total count of extracted files

Example output:

Unmixing /path/to/skill.xml...
Output directory: /tmp/extracted-files

✓ Extracted: github-ops/SKILL.md
✓ Extracted: github-ops/references/api_reference.md
✓ Extracted: markdown-tools/SKILL.md
...

✅ Successfully extracted 20 files!

Extracted files are in: /tmp/extracted-files

Supported Formats