Repomix Skill

Purpose

Generate comprehensive codebase summaries for analysis and understanding.

When Active

User needs codebase overview, unfamiliar with repo structure, preparing for full analysis.

Expertise

Usage

Local Project

repomix
# Output: repomix-output.xml

Remote Repository

repomix --remote https://github.com/owner/repo

With Configuration

Create .repomixignore to exclude files (same syntax as .gitignore).

Common Patterns

• Generate summary before full codebase review
• Create docs/codebase-summary.md from repomix output
• Check freshness: if summary >2 days old, regenerate
• Use for unfamiliar codebases or onboarding

Output Analysis

• Extract file structure and size metrics
• Identify key entry points
• Understand module organization
• Find documentation files
• Note configuration files

Patterns

Integration with Other Skills

• With Code Review: Use summary to understand scope
• With Debugging: Use for context before deep dive
• With Documentation: Extract codebase structure for docs
• With Planning: Use to assess complexity

Best Practices

• Generate fresh summary at project start
• Include summary in onboarding docs
• Update when major restructuring happens
• Use with .repomixignore for large monorepos
• Reference summary in documentation
• Cross-check with actual repo structure

Related Skills

• knowledge-retrieval — Internal-first knowledge search protocol
• docs-seeker — External documentation lookup (Context7, WebSearch)