performant-code — Claude Code skill: what it does, how to install
performant-code guides Claude Code to write fast routines for large files and strict memory caps. Helps prevent runtime timeouts on heavy workloads.
MIT ★ 1,125 updated 2026-10-27
npx skills add vstorm-co/pydantic-deepagents --skill performant-code -a claude-codeWhat performant-code does
This skill guides Claude Code when handling large datasets and tight execution bounds. It splits data processing into clear tiers: files under 100 MB fit into memory with efficient algorithms, while anything above 100 MB requires streaming or mmap. Datasets exceeding 1 GB are restricted to chunk-based processing.
The instructions focus on practical I/O and complexity fixes for C and Python. It flags nested loops for conversion to hash lookups, swaps manual counting for collections.Counter or numpy, and enforces buffered binary writes with sys.stdout.buffer.write().
Toy inputs hide memory bottlenecks, so running benchmarks against realistic file sizes before finishing is mandatory.
What it helps with
- convert quadratic nested loops into linear hash map lookups
- stream files larger than 100 MB with
mmapor buffered chunks - speed up binary record parsing via
struct.unpack - keep code execution within strict memory and file size limits
Example prompts for the agent
- Refactor this Python file reader to stream a 3 GB dataset in chunks
- Rewrite the nested loops into an O(n) hash table lookup
- Optimize this C loop using mmap and pre-allocated buffers
How to install performant-code
1Skills CLI (Vercel)
npx skills add vstorm-co/pydantic-deepagents --skill performant-code -a claude-code2Manually: put the files in place
~/.claude/skills/performant-code/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/performant-code/
1Skills CLI (Vercel)
npx skills add vstorm-co/pydantic-deepagents --skill performant-code -a codex2Manually: put the files in place
.agents/skills/performant-code/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add vstorm-co/pydantic-deepagents --skill performant-code -a cursor2Manually: put the files in place
.cursor/skills/performant-code/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install vstorm-co/pydantic-deepagents apps/cli/skills/performant-code2Manually: put the files in place
.github/skills/performant-code/SKILL.md1Skills CLI (Vercel)
npx skills add vstorm-co/pydantic-deepagents --skill performant-code -a gemini-cli2Platform CLI
gemini skills install https://github.com/vstorm-co/pydantic-deepagents --path apps/cli/skills/performant-codeManually: put the files in place
.devin/skills/performant-code/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about performant-code
How to install performant-code in Claude Code?
Run npx skills add vstorm-co/pydantic-deepagents --skill performant-code -a claude-code in your terminal. You can also place the file directly at ~/.claude/skills/performant-code/SKILL.md.
What does performant-code do?
It teaches the agent architecture patterns for high-throughput code. The skill sets rules for streaming large files, picking efficient algorithms, and applying language-level tweaks.
What optimizations does it suggest for Python?
It recommends using numpy for numeric workloads, collections.Counter instead of custom loops, list comprehensions, and struct.unpack() for binary parsing.
Source text
SKILL.md · MIT
--- name: performant-code description: "Writing efficient code that handles large data and tight constraints" tags: [performance, optimization, benchmark] version: "1.0.0" --- # Performant Code How to write code that won't timeout on large inputs. ## Think About Scale First Before writing code, ask: how big is the data? | Data size | Approach | |-----------|----------| | < 1 MB | Load into memory, any approach works | | 1-100 MB | Load into memory, but use efficient algorithms | | 100 MB - 1 GB | Stream/mmap, avoid loading entirely into memory | | > 1 GB | Streaming only, chunk-based processing | ## I/O Optimization ### Large files - **mmap** (C: `mmap()`, Python: `mmap.mmap()`) — map file into memory, OS handles paging - **Buffered binary reads** — `fread()` in C, `open(f, 'rb').read(chunk)` in Python - **NEVER** read a 500MB file line-by-line with `fgets()` when you need random access ### Writing output - Buffer writes — don't call `write()` for every byte - Use `fwrite()` or `sys.stdout.buffer.write()` for binary output - Flush only when needed ## Algorithm Complexity - **O(n)** beats **O(n log n)** beats **O(n²)** — always - Nested loops on large data = timeout. Restructure to single pass + hash map - Sorting is O(n log n) — only sort if you need to - Use hash maps/sets for lookup instead of linear search - Pre-compute what you can outside loops ## Language-Specific Tips ### C - Use `mmap()` for large file access - `-O2` or `-O3` for compiler optimizations - Avoid `malloc()`/`free()` in tight loops — pre-allocate - Use `memcpy()` instead of byte-by-byte copying - Integer arithmetic > floating point when possible ### Python - Use `numpy` for numerical work (100x faster than pure Python loops) - `collections.Counter`, `defaultdict` — avoid manual counting - List comprehensions > explicit loops - `struct.unpack()` for binary parsing - `subprocess.run()` > `os.system()` - For heavy computation: consider writing a small C program instead ### General - Profile before optimizing — find the actual bottleneck - If a program hangs, it's likely: infinite loop, deadlock, or I/O bound on huge data - If a program is slow, check: algorithm complexity, I/O pattern, memory allocation ## Constraints Awareness - If the task says "< 5000 bytes" — count your bytes, use `wc -c` - If there's a time limit — test with actual data, not toy inputs - If there's a memory limit — don't load everything into RAM - Always verify constraints BEFORE declaring done
© vstorm-co · MIT · vstorm-co/pydantic-deepagents