repomix — Claude Code skill: pack a repo into one file

What repomix does

The skill teaches the agent to drive Repomix, a tool that folds repository files into one document with clear separators. You pick the format: XML, Markdown, JSON or plain text. Token counts come per file and for the whole repo, so you can tell up front whether the context fits the model's limit.

The instructions cover the full path: check the install with repomix --version, add the package via npm install -g repomix or brew install repomix, narrow the scope with --include and -i, strip comments with --remove-comments. Remote repositories get their own section — npx repomix --remote owner/repo works without cloning. The agent follows five steps: assess the request, set filters, run the pack, review the output, deliver the file with a token summary.

Before the file leaves your machine, turn on the secret scan. Repomix uses Secretlint to catch API keys, passwords and private keys. You can switch it off with --no-security-check, and then the risk is yours. The skill suggests a .repomixignore for sensitive paths and says to keep .env out of the pack. For a third-party repo, read the output yourself before it goes anywhere near a model.