Brocmo7774

fireworks-skill-memory

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.

Brocmo7774 0 Updated 1mo ago

Resources

10
GitHub

Install

npx skillscat add brocmo7774/fireworks-skill-memory

Install via the SkillsCat registry.

SKILL.md

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:

  1. Injecting past experience when a skill is invoked (so Claude avoids repeating mistakes)
  2. Distilling new lessons at session end (using Claude Haiku, async, zero workflow impact)
  3. 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

Categories

CLI Tools Debugging
GitHub

Install

npx skillscat add brocmo7774/fireworks-skill-memory

Install via the SkillsCat registry.

Recommended Skills