/performance
Performance optimization guidelines for Splitrail. Use when optimizing parsing, reducing memory usage, or improving throughput.
$ npx -y skills add Piebald-AI/splitrail --skill performance --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/performance
Context preview
The summary Claude sees to decide when to auto-load this skill.
Performance optimization guidelines for Splitrail. Use when optimizing parsing, reducing memory usage, or improving throughput.
SKILL.md
performance.SKILL.mdname: performance description: Performance optimization guidelines for Splitrail. Use when optimizing parsing, reducing memory usage, or improving throughput.
Performance Considerations
Techniques Used
- **Parallel analyzer loading** - `futures::join_all()` for concurrent stats loading
- **Parallel file parsing** - `rayon` for parallel iteration over files
- **Fast JSON parsing** - `simd_json` exclusively for all JSON operations (note: `rmcp` crate re-exports `serde_json` for MCP server types)
- **Fast directory walking** - `jwalk` for parallel directory traversal
- **Lazy message loading** - TUI loads messages on-demand for session view
See existing analyzers in `src/analyzers/` for usage patterns.
Guidelines
1. Prefer parallel processing for I/O-bound operations 2. Use `parking_lot` locks over `std::sync` for better performance 3. Avoid loading all messages into memory when not needed 4. Use `BTreeMap` for date-ordered data (sorted iteration)
Splitrail is a fast, cross-platform, real-time token usage tracker and cost monitor for: Gemini CLI (and Qwen Code) Claude Code Codex CLI Cline / Roo Code / Zoo Code / Kilo Code (VS Code extension + CLI) GitHub Copilot (VS Code) GitHub Copilot CLI OpenCode Pi
Repo: Piebald-AI/splitrail
Other skills on splitrail.
- /mcp
Guide for working with Splitrail's MCP server. Use when adding tools, resources, or modifying the MCP interface.
Open skill - /new-analyzer
Guide for adding a new AI coding agent analyzer to Splitrail. Use when implementing support for a new tool like Copilot, Cline, or similar.
Open skill - /pricing
Guide for updating model pricing in Splitrail. Use when adding new AI model costs or updating existing pricing data.
Open skill - /tui
Guide for Splitrail's terminal UI and file watching. Use when modifying the TUI, stats display, or real-time update logic.
Open skill - /types
Reference for Splitrail's core data types. Use when working with ConversationMessage, Stats, DailyStats, or other type definitions.
Open skill