Skill: Repomix
Pack codebases into AI-friendly formats for context loading in Claude sessions.
When to Use
- •Preparing codebase context for AI code review
- •Debugging complex issues across multiple files
- •Understanding architecture of a new project
- •Sharing codebase snapshots for collaboration
- •Starting new Claude sessions with full project context
When NOT to Use
- •Simple file operations (use Read/Write tools)
- •Git operations (use /collab)
- •Searching for specific text (use Grep)
Quick Start
bash
# Pack current directory bunx repomix # Pack with compression bunx repomix --compress # Create Teslasoft bundles /repomix bundle
Commands
| Command | Action |
|---|---|
/repomix | Load Repomix context and CLI reference |
/repomix pack | Pack current directory |
/repomix pack --compress | Pack with token compression |
/repomix auto | Intelligent auto-discovery based on project type |
/repomix bundle | Create all Teslasoft bundles |
/repomix bundle --vault | Create vault bundle only |
/repomix bundle --web | Create all web segment bundles |
/repomix status | Show existing bundles and freshness |
/repomix help | Show CLI quick reference |
Bundle Storage
Location: D:\TeamProjects\Teslasoft\.repomix-bundles\
| Bundle | Content | ~Tokens |
|---|---|---|
vault-bundle.xml | Obsidian vault (goals, projects, resources) | 67K |
web-app.xml | Core framework (base, common, layout) | 23K |
web-modules.xml | Feature modules (api, dashboard, docs) | 32K |
web-e2e.xml | Cypress E2E tests | 7K |
web-config.xml | Build configs (nx, tsconfig) | 5K |
See Bundle Workflow for details.
Output Formats
| Format | Flag | Use Case |
|---|---|---|
| XML | --style xml (default) | Best for LLMs |
| Markdown | --style markdown | Human-readable |
| JSON | --style json | Programmatic |
Failure Modes & Recovery
| Issue | Recovery |
|---|---|
| Bundle too large | Use segmented bundles (--web-app, --web-modules) |
| Security warning | Review flagged files, use --no-security-check if safe |
| Token limit exceeded | Use --compress flag, filter with --include |
| Stale bundles | Run /repomix bundle to refresh |
Security & Permissions
- •Required tools: Bash (bunx commands)
- •Security check: Enabled by default via secretlint
- •Confirmations: Old bundles deleted before regeneration
- •Trust model: Local files only, no external uploads
Best Practices
- •Use segmented bundles for targeted context loading
- •Always compress large codebases (
--compress) - •Check bundle status regularly (
/repomix status) - •Start new sessions with fresh bundles for best results
- •Use task-specific bundles (e.g., web-e2e for E2E testing)
References
- •CLI Reference - Full command documentation
- •Bundle Workflow - Bundle creation process
- •Auto-Discovery - Intelligent file selection
- •Teslasoft Integration - Project-specific workflows
Metadata
yaml
author: Christian Kusmanow / Claude version: 2.0.0 last_updated: 2026-01-23 change_surface: references/ (CLI updates, new bundle types) extension_points: references/bundle-workflow.md (new bundle segments)
Changelog
- •v2.0.0 (2026-01-23): SDL migration - Progressive disclosure structure
- •Split 796-line monolith into SKILL.md (~150 lines) + 4 references
- •Added YAML frontmatter with triggers and negative_triggers
- •Added security section and failure modes
- •v1.4.0 (2026-01-23): Segmented web bundles (82% token reduction)
- •v1.3.0 (2026-01-23): Added
bundleandstatuscommands - •v1.2.0 (2026-01-23): Enhanced auto-discovery with project type detection
- •v1.1.0 (2026-01-23): Added
autoargument for intelligent file selection