repomix-explorer_skill

Overview

This skill uses the Repomix CLI to analyze and explore codebases, producing structured output you can search and inspect. I run repomix commands, parse the generated XML (or other formats), then surface repository structure, metrics, and pattern-based findings. Results are concise, actionable, and include next-step recommendations.

How this skill works

I determine whether the target is remote or local and run the appropriate repomix command (remote output goes to /tmp by default). I prefer XML output and use --compress for large repositories. After repomix finishes, I extract metrics, read the file tree section, run targeted grep searches for patterns, and open relevant file fragments for context before summarizing findings and recommended next steps.

When to use it

• You need a quick structural overview of a repository or directory.
• You want to find specific patterns (auth, API endpoints, models, exports).
• You need metrics: file count, token estimate, or largest files.
• Exploring a dotfiles repo (neovim, nix, tmux, git) to locate configs and plugins.
• Preparing targeted reviews or refactors and want entry points and hotspots.

Best practices

• Use --compress for repositories >100k lines to reduce token count (~70%).
• Always output remote analyses to /tmp to avoid polluting the working directory.
• Run grep pattern searches before reading large output files to narrow scope.
• Choose XML for structured analysis; use JSON if you need programmatic parsing.
• Set --output to unique paths when analyzing multiple repositories to avoid overwrites.

Example use cases

• Analyze a local dotfiles folder to list neovim config files, tmux.conf, and nix flakes.
• Explore a remote GitHub repo to count files and identify main entry points (index, init).
• Find all authentication-related code by grepping for auth/login/token patterns.
• List largest files and estimate token usage before planning an AI-based code review.
• Include only specific file types (e.g., **/*.{lua,conf,nix}) to focus the analysis.