Use when Claude Code hits "File content exceeds maximum allowed tokens" error, or when files are too large to read. Helps analyze and break apart large files into smaller, focused modules.
/plugin marketplace add blueraai/bluera-base/plugin install bluera-base@blueraThis skill is limited to using the following tools:
references/analysis-strategies.mdreferences/breakout-patterns.mdreferences/validation-checklist.mdGuide for analyzing and breaking apart files that exceed Claude Code's read limits.
# Get line count
wc -l <file>
# Get structure overview (Rust example)
grep -n "^pub fn\|^fn\|^impl\|^struct\|^enum\|^mod" <file>
Use LSP documentSymbol for accurate symbol outline.
Look for cohesive groups:
Target: Each new file should be 200-500 lines (readable in one read).
| Pattern | When to Use |
|---|---|
| Extract to submodule | Related impl blocks, feature code |
| Extract to sibling file | Independent utilities, types |
| Create package/directory | Multiple related modules |
Read (offset/limit) + WriteWhen you can't read the whole file:
| Tool | Use For |
|---|---|
Grep | Find definitions: ^fn, ^class, ^def, impl |
LSP documentSymbol | Get complete symbol outline |
Read with offset/limit | Read specific sections |
wc -l | Total line count |
Example workflow:
1. wc -l file.rs # 3500 lines
2. grep -n "^impl" file.rs # Find impl blocks at lines 100, 800, 2000
3. LSP documentSymbol file.rs # Get full structure
4. Read file.rs offset=100 limit=200 # Read first impl block
| File Size | Recommendation |
|---|---|
| < 500 lines | Usually fine as-is |
| 500-1000 lines | Consider splitting if multiple concerns |
| 1000-2000 lines | Should split unless highly cohesive |
| > 2000 lines | Must split for maintainability |
See @large-file-refactor/references/breakout-patterns.md for detailed examples.
| Language | Primary Pattern |
|---|---|
| Rust | Submodules in directory, re-export from mod.rs |
| TypeScript | Separate files, barrel export from index.ts |
| Python | Package with init.py |
| Go | Multiple files in same package |
@large-file-refactor/references/analysis-strategies.md - Detailed analysis techniques@large-file-refactor/references/breakout-patterns.md - Language-specific examples@large-file-refactor/references/validation-checklist.md - Pre/post refactor checksActivates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use for discovering, retrieving, and improving prompts.
Activates when the user asks about Agent Skills, wants to find reusable AI capabilities, needs to install skills, or mentions skills for Claude. Use for discovering, retrieving, and installing skills.
This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.