| name | fireworks-skill-memory |
| description | Persistent cross-session experience memory for Claude Code skills. TRIGGER when user asks about skill memory, experience distillation, cross-session learning, skill knowledge injection, Claude memory, session-to-session improvement, or wants to install/configure fireworks-skill-memory. |
fireworks-skill-memory
Persistent experience memory for Claude Code skills. Claude remembers what it learned — session after session, skill by skill.
What It Does
Every Claude Code session starts from zero. The same mistakes repeat — wrong API parameters, broken sequences, proxy pitfalls — because Claude has no memory between sessions.
fireworks-skill-memory solves this by automatically:
- Injecting past experience when a skill is invoked (so Claude avoids repeating mistakes)
- Distilling new lessons at session end (using Claude Haiku, async, zero workflow impact)
- Growing smarter over time with HIT-counted entries and age-based eviction
Installation
Quick Install (Recommended)
In Claude Code, say:
"Help me install fireworks-skill-memory from https://github.com/yizhiyanhua-ai/fireworks-skill-memory"
Or run the one-command installer:
curl -fsSL https://raw.githubusercontent.com/yizhiyanhua-ai/fireworks-skill-memory/main/install.sh | bash
npx skills Install
npx skills add yizhiyanhua-ai/fireworks-skill-memory -g
After installing via npx skills, run the installer to set up hooks:
curl -fsSL https://raw.githubusercontent.com/yizhiyanhua-ai/fireworks-skill-memory/main/install.sh | bash
How It Works
The system installs 4 Claude Code hooks that run automatically:
| Hook | Trigger | Script | Purpose |
|---|
PreToolUse | Before Skill call | pre-skill-inject.py | Inject full KNOWLEDGE.md before skill executes |
PostToolUse | After Read SKILL.md | inject-skill-knowledge.py | Inject top-N entries by relevance + capture error seeds |
PostToolUse | After any tool call | error-seed-capture.py | Capture error signals to session-scoped file |
Stop | Session end (async) | update-skills-knowledge.py | Distill new lessons via Haiku, update KNOWLEDGE.md |
Data Flow
Skill invoked → PreToolUse injects experience → Claude executes with context
↓
Session ends → Stop hook reads transcript → Haiku distills 1-3 lessons
↓
KNOWLEDGE.md updated → Ready for next session
Knowledge Storage
~/.claude/skills/<skill-name>/KNOWLEDGE.md ← Per-skill experience (max 100 entries)
~/.claude/skills-knowledge.md ← Global cross-skill principles (max 100 entries)
~/.claude/skill-usage-stats.json ← Usage frequency stats
~/.claude/skill-memory.log ← Execution log
Each entry is tagged with [YYYY-MM] timestamp and [HIT:N] usage counter. Low-frequency, old entries are evicted first.
Configuration (Optional)
All settings are optional, configured via environment variables:
| Variable | Default | Description |
|---|
SKILLS_KNOWLEDGE_MODEL | claude-haiku-4-5 | Model for distillation |
SKILL_MAX | 100 | Max entries per skill |
GLOBAL_MAX | 100 | Max global entries |
MIN_TOOL_CALLS | 5 | Skip sessions with fewer calls (likely summaries) |
SKILLS_INJECT_TOP | 20 | Max entries injected per active invocation |
Requirements
- Python 3.9+
- Claude Code CLI
- Claude Haiku access (for distillation; falls back through haiku-4-5 → haiku-3-5)
More Information
