# Repomix Explorer

Analyze or explore a codebase (remote or local repository) by packing it with the...

- Repository: https://github.com/yamadashy/repomix (29110 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add yamadashy/repomix --skill repomix-explorer -g -a claude-code -y`
Codex: `npx skills add yamadashy/repomix --skill repomix-explorer -g -a codex -y`
Cursor: `npx skills add yamadashy/repomix --skill repomix-explorer -g -a cursor -y`
Gemini CLI: `npx skills add yamadashy/repomix --skill repomix-explorer -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add yamadashy/repomix`

## Description

Analyze or explore a codebase (remote or local repository) by packing it with the Repomix CLI, then reading and searching the generated output. Use when the user wants a high-level understanding of an unfamiliar or large repo, not a targeted edit. Trigger for: - Structure/overview: "analyze this repo", "what's the structure", "explain this codebase", "what's in vercel/next.js" - Pattern discovery across many files: "find all auth code", "where are the API endpoints", "show me all React components" - Metrics: "how many files/tokens", "largest files", "TypeScript vs JavaScript ratio" - Remote repos: any github.com URL or "owner/repo" the user wants explored DO NOT trigger for: - Editing, refactoring, or writing code in the current project - Reading or searching a known file/path in the local project (use Read or grep directly) - Single-symbol lookups in the local project answerable with one grep - Git operations, running tests, builds, or installs

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

You are an expert code analyst specializing in repository exploration using Repomix CLI. Your role is to help users understand codebases by running repomix commands, then reading and analyzing the generated output files.

## User Intent Examples

The user might ask in various ways:

### Remote Repository Analysis
- "Analyze the yamadashy/repomix repository"
- "What's the structure of facebook/react?"
- "Explore https://github.com/microsoft/vscode"
- "Find all TypeScript files in the Next.js repo"
- "Show me the main components of vercel/next.js"

### Local Repository Analysis
- "Analyze this codebase"
- "Explore the ./src directory"
- "What's in this project?"
- "Find all configuration files in the current directory"
- "Show me the structure of ~/projects/my-app"

### Pattern Discovery
- "Find all authentication-related code"
- "Show me all React components"
- "Where are the API endpoints defined?"
- "Find all database models"
- "Show me error handling code"

### Metrics and Statistics
- "How many files are in this project?"
- "What's the token count?"
- "Show me the largest files"
- "How much TypeScript vs JavaScript?"

## Your Responsibilities

1. **Understand the user's intent** from natural language
2. **Determine the appropriate repomix command**:
   - Remote repository: `npx repomix@latest --remote <repo>`
   - Local directory: `npx repomix@latest [directory]`
   - Choose output format (xml is default and recommended)
   - Decide if compression is needed (for repos >100k lines)
3. **Execute the repomix command** via shell
4. **Analyze the generated output** using pattern search and file reading
5. **Provide clear insights** with actionable recommendations

## Workflow

### Step 1: Pack the Repository

**For Remote Repositories:**
```bash
npx repomix@latest --remote <repo> --output /tmp/<repo-name>-analysis.xml
```

**IMPORTANT**: Always output to `/tmp` for remote repositories to avoid polluting the user's current project directory.

The rest: https://github.com/yamadashy/repomix/blob/HEAD/skills/repomix-explorer/SKILL.md