Back to Skills

repomix-explorer

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 componen

27,908stars1,490forksUpdated 8/17/2026

Security Assessment

Safe(93/100)
Security Score93/100

About repomix-explorer

Repomix Explorer is a codebase-analysis skill that helps users understand an unfamiliar or large repository, remote or local, by packing it with the Repomix CLI and then reading and searching the generated output. It is aimed at high-level comprehension rather than targeted edits: getting a structural overview, discovering patterns across many files, or gathering metrics like file and token counts and language ratios.

The workflow packs the repo with npx repomix@latest, using --remote for GitHub repos (always writing the output to /tmp to avoid polluting the user's project) or a local directory path, and choosing an output format (XML by default, with markdown, JSON, or plain available) and optional Tree-sitter --compress for large repos. It then checks the reported metrics, searches the packed output with grep patterns for functions, classes, imports, config, auth, API endpoints, models, and error handling, and reads specific sections with offset/limit before summarizing findings and suggesting next steps. The skill is explicit about what NOT to trigger on: editing or refactoring the current project, reading a known local file (use Read or grep directly), single-symbol lookups, or git/test/build/install operations. It offers optional cleanup of large output files after analysis.

Target users are developers, reviewers, and technical writers who need a fast, read-only orientation to a codebase, especially remote GitHub repositories they want to explore before diving in. Its operations are read-only analysis: it packs, greps, and reads, and only deletes the temporary Repomix output file it created.

FAQ

What does this skill do?

It packs a repository with the Repomix CLI, then reads and greps the generated output to give you a structural overview, cross-file pattern discovery, and metrics like file and token counts.

Does it work on remote GitHub repos?

Yes. It uses npx repomix@latest --remote for GitHub repos or 'owner/repo' references, always writing the output to /tmp so it doesn't pollute your current project directory.

When should I not use it?

Not for editing or refactoring the current project, reading a known local file (use Read or grep directly), single-symbol lookups, or git/test/build/install operations.

How does it handle very large repositories?

It recommends the --compress flag (Tree-sitter, roughly 70% token reduction) for repos over ~100k lines, and greping the packed output before reading whole files.

Does it modify or delete anything?

Its operations are read-only analysis; the only deletion is optional cleanup of the temporary Repomix output file it generated.

Install repomix-explorer

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill