Lazy Skill Loader
On-demand skill loading to reduce context bloat. Skills in ~/.claude/lazy-skills/ are only read when explicitly requested.
Index
Skills available for lazy loading (name: keywords - description):
- •threejs-skills [collection]: threejs, 3d, webgl, graphics - "Three.js skills for 3D graphics (10 skills)"
Behavior
On Invocation
- •If
$ARGUMENTSprovided, filter index to matching keywords - •If blank, show full index
- •Always ask user which skill to load before reading - never read all skills
- •Use Read tool to load the selected skill file
Path Resolution
Single skills - try in order:
- •
~/.claude/lazy-skills/<name>.md - •
~/.claude/lazy-skills/<name>/SKILL.md
Collections (marked with [collection] in index):
- •Read
~/.claude/lazy-skills/<name>/README.mdto show available skills - •Ask user which specific skill to load
- •Read
~/.claude/lazy-skills/<name>/skills/<skill-name>/SKILL.md
After Loading
- •Skill content is now in context
- •Follow the loaded skill's instructions
- •No separate "invoke" step - it's just knowledge now
Adding Skills to Index
Edit this file's Index section:
markdown
- **skillname**: keyword1, keyword2, keyword3 - "One-line description"
Then place the skill file at either:
- •
~/.claude/lazy-skills/skillname.md(single file) - •
~/.claude/lazy-skills/skillname/SKILL.md(full skill folder, e.g., cloned repo)
Examples
Single skill:
code
User: /lazy-skill stripe Claude: Found 1 matching skill: - **stripe**: payments, billing, checkout - "Stripe API operations" Want me to load it? User: yes Claude: [Reads ~/.claude/lazy-skills/stripe.md] Loaded stripe skill. What would you like to do?
Collection:
code
User: /lazy-skill threejs Claude: Found 1 matching collection: - **threejs-skills** [collection]: threejs, 3d, webgl - "Three.js skills (10 skills)" Want me to show the available skills in this collection? User: yes Claude: [Reads ~/.claude/lazy-skills/threejs-skills/README.md] Available skills in threejs-skills: | Skill | Description | |-------|-------------| | threejs-fundamentals | Scene setup, cameras, renderer | | threejs-geometry | Shapes, BufferGeometry, instancing | | threejs-materials | PBR, shader materials | ... (7 more) Which one should I load? User: fundamentals Claude: [Reads ~/.claude/lazy-skills/threejs-skills/skills/threejs-fundamentals/SKILL.md] Loaded threejs-fundamentals. Ready to help with Three.js scene setup.
<instructions>$ARGUMENTS</instructions>