# repomix

This skill packs a whole repository into a single file you can hand to an LLM. Useful when an agent needs project context or you want to read someone else's library.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 402 installs · ★ 2228
- Author: mrgoonie
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mrgoonie/claudekit-skills/tree/HEAD/.claude/skills/repomix/SKILL.md
- Updated: 2026-04-03
- HTML: https://affpapa.org/en/nevibecode/skills/repomix

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add mrgoonie/claudekit-skills --skill repomix -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/repomix/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/repomix/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add mrgoonie/claudekit-skills --skill repomix -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/repomix/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add mrgoonie/claudekit-skills --skill repomix -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/repomix/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mrgoonie/claudekit-skills repomix
```

2. **Manually: put the files in place**
- File: `.github/skills/repomix/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add mrgoonie/claudekit-skills --skill repomix -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/mrgoonie/claudekit-skills --path .claude/skills/repomix
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/repomix/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add mrgoonie/claudekit-skills --skill repomix -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/mrgoonie/claudekit-skills/tree/HEAD/.claude/skills/repomix/SKILL.md

## When to use it
- pack a full repository into one file for LLM context
- inspect a third-party library without cloning it
- prepare a code snapshot for a security audit
- strip comments before sending code to a model
- count tokens to see if the project fits the context limit

## Example prompts
- Pack this repo as markdown, only `src/**/*.ts`, comments removed
- Snapshot the remote repo `vendor/library` as XML for an audit
- Build context from `src/auth/**` and `src/api/**` and show the token count

## Similar
- [repomix-safe-mixer](https://affpapa.org/en/nevibecode/skills/repomix-safe-mixer.md) — skill · 912 installs
- [repomix-explorer](https://affpapa.org/en/nevibecode/skills/repomix-explorer.md) — skill · 1900 installs
- [repomix-unmixer](https://affpapa.org/en/nevibecode/skills/repomix-unmixer.md) — skill · 882 installs
- [learn-codebase](https://affpapa.org/en/nevibecode/skills/learn-codebase.md) — skill · 5300 installs
- [deepinit](https://affpapa.org/en/nevibecode/skills/deepinit.md) — skill · 1000 installs
- [ghost-repo-context](https://affpapa.org/en/nevibecode/skills/ghost-repo-context.md) — skill · 3800 installs

From the same set: [mrgoonie/claudekit-skills](https://affpapa.org/en/nevibecode/by/mrgoonie/claudekit-skills.md) — 21 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md