Agent skill

Repomix Unmixer

by daymade in daymade/claude-code-skills

Extracts files from repomix-packed repositories, restoring original directory structures from XML/Markdown/JSON formats.

MITAuto-check passedAgent Workflows

Install Repomix Unmixer

skills CLI
$ npx skills add daymade/claude-code-skills --skill repomix-unmixer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install daymade/claude-code-skills repomix-unmixer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/daymade/claude-code-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/repomix-unmixer .claude/skills/repomix-unmixer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
repomix-unmixer
GitHub stars
1.4k
Token cost
~2.1k tokens
SKILL.md length
724 words
Files
5 (incl. scripts, references)
Skills in repo
104
Repo updated
First seen
Licence
MIT

At a glance

Extracts files from repomix-packed repositories, restoring original directory structures from XML/Markdown/JSON formats.

  • Works in 5 steps: Parses the repomix file format (XML,… → Extracts each file path and content → Creates the original directory structure → …
  • Tasks that involve Codebase knowledge for agents
  • SKILL.md covers Overview, When to Use This Skill, Core Workflow and Supported Formats, plus 6 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Repomix Unmixer is an agent skill from daymade/claude-code-skills. Extracts files from repomix-packed repositories, restoring original directory structures from XML/Markdown/JSON formats. Activates when users need to unmix repomix files, extract packed repositories, restore file structures from repomix output, or reverse the repomix packing process.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `README.md`, `references/repomix-format.md` and `references/validation-workflow.md`).

It sits in Agent Workflows, covering Codebase knowledge for agents. The repository describes itself as: Professional Claude Code skills marketplace featuring production-ready skills for enhanced development workflows. The licence is MIT.

When your agent uses it

  • Tasks that involve Codebase knowledge for agents

Example prompts

  • “Use the repomix-unmixer skill to extract files from repomix-packed repositories, restoring original directory structures from XML/Markdown/JSON…”
  • “/repomix-unmixer”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  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

What it can do on your machine

Read from SKILL.md and the folder at commit 0e52df5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Repomix Unmixer loads about 2.1k tokens when it runs, and up to ~7.1k if it reads all its reference files. Until then it costs about 75 tokens; SKILL.md has 724 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from daymade/claude-code-skills at commit 0e52df5, republished under its MIT licence (© daymade). 724 words, ~2,065 tokens.

Download SKILL.mdSave it as .claude/skills/repomix-unmixer/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
repomix-unmixer
description
Extracts files from repomix-packed repositories, restoring original directory structures from XML/Markdown/JSON formats. Activates when users need to unmix repomix files, extract packed repositories, restore file structures from repomix output, or reverse the repomix packing process.

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:

bash
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:

bash
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

XML Format (default)

Repomix XML format structure:

xml
<file path="relative/path/to/file.ext">
file content here
</file>

The script uses regex to match <file path="...">content</file> blocks.

Markdown Format

For markdown-style repomix output with file markers:

markdown
## File: relative/path/to/file.ext

file content

Refer to references/repomix-format.md for detailed format specifications.

JSON Format

For JSON-style repomix output:

json
{
  "files": [
    {
      "path": "relative/path/to/file.ext",
      "content": "file content here"
    }
  ]
}

Common Use Cases

Use Case 1: Unmix Claude Skills

Extract skills that were shared as a repomix file:

bash
python3 scripts/unmix_repomix.py \
  "/path/to/skills.xml" \
  "/tmp/unmixed-skills"

Then review, validate, or install the extracted skills.

Use Case 2: Extract Repository for Review

Extract a packed repository to review its structure and contents:

bash
python3 scripts/unmix_repomix.py \
  "/path/to/repo-output.xml" \
  "/tmp/review-repo"

# Review the structure
tree /tmp/review-repo
Use Case 3: Restore Working Files

Restore files from a repomix backup to a working directory:

bash
python3 scripts/unmix_repomix.py \
  "/path/to/backup.xml" \
  "~/workspace/restored-project"

Validation Workflow

After unmixing, validate the extracted files are correct:

  1. Check file count: Verify the number of extracted files matches expectations
  2. Review structure: Use tree or ls -R to inspect directory layout
  3. Spot check content: Read a few key files to verify content integrity
  4. Run validation: For skills, use the skill-creator validation tools

Refer to references/validation-workflow.md for detailed validation procedures, especially for unmixing Claude skills.

Important Principles

Always Specify Output Directory

Always provide an output directory to avoid cluttering the current working directory:

bash
# Good: Explicit output directory
python3 scripts/unmix_repomix.py \
  "input.xml" "/tmp/output"

# Avoid: Default output (may clutter current directory)
python3 scripts/unmix_repomix.py "input.xml"
Use Temporary Directories for Review

Extract to temporary directories first for review:

bash
# Extract to /tmp for review
python3 scripts/unmix_repomix.py \
  "skills.xml" "/tmp/review-skills"

# Review the contents
tree /tmp/review-skills

# If satisfied, copy to final destination
cp -r /tmp/review-skills ~/.claude/skills/
Verify Before Overwriting

Never extract directly to important directories without review:

bash
# Bad: Might overwrite existing files
python3 scripts/unmix_repomix.py \
  "repo.xml" "~/workspace/my-project"

# Good: Extract to temp, review, then move
python3 scripts/unmix_repomix.py \
  "repo.xml" "/tmp/extracted"
# Review, then:
mv /tmp/extracted ~/workspace/my-project

Troubleshooting

Show full SKILL.md (313 more words)Show less
No Files Extracted

Issue: Script completes but no files are extracted.

Possible causes:

  • Wrong file format (not a repomix file)
  • Unsupported repomix format version
  • File path pattern doesn't match

Solution:

  1. Verify the input file is a repomix output file
  2. Check the format (XML/Markdown/JSON)
  3. Examine the file structure manually
  4. Refer to references/repomix-format.md for format details
Permission Errors

Issue: Cannot write to output directory.

Solution:

bash
# Ensure output directory is writable
mkdir -p /tmp/output
chmod 755 /tmp/output

# Or use a directory you own
python3 scripts/unmix_repomix.py \
  "input.xml" "$HOME/extracted"
Encoding Issues

Issue: Special characters appear garbled in extracted files.

Solution: The script uses UTF-8 encoding by default. If issues persist:

  • Check the original repomix file encoding
  • Verify the file was created correctly
  • Report the issue with specific character examples
Path Already Exists

Issue: Files exist at extraction path.

Solution:

bash
# Option 1: Use a fresh output directory
python3 scripts/unmix_repomix.py \
  "input.xml" "/tmp/output-$(date +%s)"

# Option 2: Clear the directory first
rm -rf /tmp/output && mkdir /tmp/output
python3 scripts/unmix_repomix.py \
  "input.xml" "/tmp/output"

Best Practices

  1. Extract to temp directories - Always extract to /tmp or similar for initial review
  2. Verify file count - Check that extracted file count matches expectations
  3. Review structure - Use tree to inspect directory layout before use
  4. Check content - Spot-check a few files to ensure content is intact
  5. Use validation tools - For skills, use skill-creator validation after unmixing
  6. Preserve originals - Keep the original repomix file as backup

Resources

scripts/unmix_repomix.py

Main unmixing script that:

  • Parses repomix XML/Markdown/JSON formats
  • Extracts file paths and content using regex
  • Creates directory structures automatically
  • Writes files to their original locations
  • Reports extraction progress and statistics

The script is self-contained and requires only Python 3 standard library.

references/repomix-format.md

Comprehensive documentation of repomix file formats including:

  • XML format structure and examples
  • Markdown format patterns
  • JSON format schema
  • File path encoding rules
  • Content extraction patterns
  • Format version differences

Load this reference when dealing with format-specific issues or supporting new repomix versions.

references/validation-workflow.md

Detailed validation procedures for extracted content including:

  • File count verification steps
  • Directory structure validation
  • Content integrity checks
  • Skill-specific validation using skill-creator tools
  • Quality assurance checklists

Load this reference when users need to validate unmixed skills or verify extraction quality.

© daymade, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references) in repomix-unmixer of daymade/claude-code-skills.

  • SKILL.md
  • README.md
  • references/repomix-format.md
  • references/validation-workflow.md
  • scripts/unmix_repomix.py

Open the folder on GitHubat commit 0e52df5

Compare with similar skills

Repomix Unmixer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Repomix Unmixer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Repomix Unmixer this skilldaymade/claude-code-skills1.4k—~2.1kAutomated safety check: PassMIT
ccc Semantic Code Searchcocoindex-io/cocoindex-code2.8k—~938Automated safety check: PassApache-2.0
Context Engineeringabashev/vfs-s31069 repos~2.6kAutomated safety check: NotesApache-2.0
Repomix Codebase Packeryamadashy/repomix29k—~1.3kAutomated safety check: NotesMIT
Codebase Handbook BuilderRuhan-Wang/Harness_Handbook334—~2.2kAutomated safety check: PassApache-2.0
CodemapJordanCoin/codemap703—~1.8kAutomated safety check: PassMIT

Similar skills

  • ccc Semantic Code Search

    cocoindex-io/cocoindex-code

    Semantic code search and index management with the ccc CLI: the agent initializes, indexes and queries the project by concept, filtering by language or path.

    2.8k GitHub stars~938 tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Context Engineering

    abashev/vfs-s3

    Optimizes agent context setup. An agent skill from abashev/vfs-s3.

    106 GitHub starsUsed in 9 repos~2.6k tokens
    Agent WorkflowsAuto-check: notes
  • Repomix Codebase Packer

    yamadashy/repomix

    Packs a local directory or remote GitHub repository into one AI-friendly file with Repomix, then searches it to explore structure, find patterns and count tokens.

    29k GitHub stars~1.3k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Codebase Handbook Builder

    Ruhan-Wang/Harness_Handbook

    Generates, refreshes, validates and uses a compact handbook that maps where a change touches in a repository, using the active Codex session and no external LLM API.

    334 GitHub stars~2.2k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Codemap

    JordanCoin/codemap

    Gives an agent a quick map of a codebase's structure, dependencies, changes and handoffs, and tunes per-project config so the output stays code-first.

    703 GitHub stars~1.8k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Repomix Context Skill

    sopaco/deepwiki-rs

    A skill your agent uses when an agent needs source code from the local repomix index under .terrain/agent/repomix.md (not committed; regenerate via Terrain scan).

    3.1k GitHub stars~671 tokensUpdated 26 days ago
    Agent WorkflowsAuto-check passed

More from daymade/claude-code-skills

All 104 skills in this repo
  • Video Comparer

    daymade/claude-code-skills

    This skill should be used when comparing two videos to analyze compression results or quality differences.

    1.4k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check: notes
  • CLI Demo Generator

    daymade/claude-code-skills

    Generates professional animated CLI demos as GIFs using VHS terminal recordings.

    1.4k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Doc To Markdown

    daymade/claude-code-skills

    Converts DOCX/PDF/PPTX and saved HTML/HTM to high-quality Markdown with automatic post-processing.

    1.4k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Interaction Design Board

    daymade/claude-code-skills

    Generates several distinct, clickable HTML interaction prototypes for one product surface into a Design Board and collects selection/remix feedback before implementation.

    1.4k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Skill Creator

    daymade/claude-code-skills

    Creates, edits and benchmarks skills; supersedes the official skill-creator plugin, so when both are listed, use this one.

    1.4k GitHub stars~4.3k tokensUpdated today
    Auto-check passed
  • Auto Repo Setup

    daymade/claude-code-skills

    Diagnoses and repairs repository setup and guarded Git workflows for Claude Code or Codex — environment repair, startup sync, hook auditing, collaborator handoff.

    1.4k GitHub stars~2.9k tokensUpdated today
    Auto-check: notes

Categories

Questions about Repomix Unmixer

What does Repomix Unmixer do?

Extracts files from repomix-packed repositories, restoring original directory structures from XML/Markdown/JSON formats. Repomix Unmixer is an agent skill from daymade/claude-code-skills. Extracts files from repomix-packed repositories, restoring original directory structures from XML/Markdown/JSON formats.

When should I use Repomix Unmixer?

Repomix Unmixer fits situations like: tasks that involve Codebase knowledge for agents.

How do I install Repomix Unmixer in Claude Code?

Run `npx skills add daymade/claude-code-skills --skill repomix-unmixer -a claude-code`. Or copy the skill folder (repomix-unmixer in daymade/claude-code-skills) into .claude/skills/repomix-unmixer in your project. Claude Code loads it when a task matches its description.

How do I install Repomix Unmixer in Codex?

Run `npx skills add daymade/claude-code-skills --skill repomix-unmixer -a codex`. Or copy the skill folder (repomix-unmixer in daymade/claude-code-skills) into .agents/skills/repomix-unmixer in your project. Codex loads it when a task matches its description.

Can I use Repomix Unmixer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add daymade/claude-code-skills --skill repomix-unmixer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/repomix-unmixer, .gemini/skills/repomix-unmixer, .github/skills/repomix-unmixer and .opencode/skills/repomix-unmixer in your project.

What does Repomix Unmixer need to run?

Going by SKILL.md and its folder, Repomix Unmixer needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Repomix Unmixer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Repomix Unmixer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Repomix Unmixer use?

Repomix Unmixer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Repomix Unmixer use?

About 2.1k tokens (SKILL.md is roughly 8.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.1k tokens, read only when the agent opens those files.

What are the alternatives to Repomix Unmixer?

Skills that share tags, products or a category with Repomix Unmixer: ccc Semantic Code Search (cocoindex-io/cocoindex-code, 2.8k stars), Context Engineering (abashev/vfs-s3, 106 stars), Repomix Codebase Packer (yamadashy/repomix, 29k stars) and Codebase Handbook Builder (Ruhan-Wang/Harness_Handbook, 334 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Repomix Unmixer?

daymade (a GitHub user) maintains it in daymade/claude-code-skills, which has 1,448 GitHub stars. The repository holds 104 skills in this directory. The repository was last updated on October 10, 2026.

Source: daymade/claude-code-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.