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

1. If $ARGUMENTS provided, filter index to matching keywords
2. If blank, show full index
3. Always ask user which skill to load before reading - never read all skills
4. Use Read tool to load the selected skill file

Path Resolution

Single skills - try in order:

1. ~/.claude/lazy-skills/<name>.md
2. ~/.claude/lazy-skills/<name>/SKILL.md

Collections (marked with [collection] in index):

1. Read ~/.claude/lazy-skills/<name>/README.md to show available skills
2. Ask user which specific skill to load
3. 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:

- **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:

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:

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>