markdown-memory skill
A file-based lesson memory that Claude Fable 5 / 5.1 reads and maintains across sessions. Use for any recurring agent (daily jobs, long projects, team assistants) where the same corrections keep being re-made, and when bootstrapping a new agent from past session history. Fable 5 benefits from recorded lessons noticeably more than prior models did.
- GitHub stars
- 19
- Files
- 1
- Last commit
- Sep 2, 2026
- License
- MIT
- Allowed tools
- —
What does the markdown-memory skill do?
markdown-memory is a file-based lesson memory that Claude Fable 5 / 5.1 reads and maintains across sessions. Use for any recurring agent (daily jobs, long projects, team assistants) where the same corrections keep being re-made, and when bootstrapping a new agent from past session history. Fable 5 benefits from recorded lessons noticeably more than prior models did.
How to install the markdown-memory skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the markdown-memory skill in Plugin
/plugin marketplace add kpab/claude-fable-5-skills /plugin install fable5-skills@claude-fable-5-skills
Install the markdown-memory skill in Claude Code
~/.claude/skills/markdown-memory/SKILL.md
$ npx degit kpab/claude-fable-5-skills/skills/markdown-memory ~/.claude/skills/markdown-memoryInstall the markdown-memory skill in Claude Code (project)
.claude/skills/markdown-memory/SKILL.md
$ npx degit kpab/claude-fable-5-skills/skills/markdown-memory .claude/skills/markdown-memoryInstall the markdown-memory skill in Codex
~/.agents/skills/markdown-memory/SKILL.md
$ npx degit kpab/claude-fable-5-skills/skills/markdown-memory ~/.agents/skills/markdown-memoryInstall the markdown-memory skill in Gemini CLI
~/.gemini/skills/markdown-memory/SKILL.md
$ npx degit kpab/claude-fable-5-skills/skills/markdown-memory ~/.gemini/skills/markdown-memoryInstall the markdown-memory skill in Claude.ai
npx degit kpab/claude-fable-5-skills/skills/markdown-memory markdown-memory && zip -r markdown-memory.zip markdown-memory # claude.ai → Customize → Skills → + → Create skill → Upload a skill → markdown-memory.zip
SKILL.md
View on GitHubMarkdown Memory
Fable 5 is unusually good at exploiting written records of its own past mistakes and confirmed approaches. A directory of Markdown files is enough — no database required. What matters is the maintenance discipline, because a memory full of stale or duplicate notes is worse than none.
Layout
memory/
lessons/
one-lesson-per-file.md
INDEX.md # one line per lesson, regenerated when lessons change
Lesson file format
- Line 1: a one-sentence summary that makes sense without opening the file.
- Body: what happened, what the correct approach is, and why it mattered — the why is what generalizes.
- Record both corrections (things that went wrong) and confirmations (approaches validated under pressure).
Maintenance rules
- One lesson per file. If a new event refines an existing lesson, update that file; never create a near-duplicate.
- Don't record what the repo, docs, or chat history already state — memory is for what's not written down elsewhere.
- Delete lessons proven wrong. A confidently wrong note does more damage than a missing one.
- Read INDEX.md at session start; open full lesson files only when relevant.
Bootstrapping from history
To seed memory for an existing project, review past sessions (delegating chunks to subagents if history is large), extract recurring themes and corrections, and write them as lesson files in the format above. Then make reading INDEX.md part of the standing instructions.
Files in this skill
1markdown-memory skill questions
How do I install the markdown-memory skill in Claude Code?
Run npx degit kpab/claude-fable-5-skills/skills/markdown-memory ~/.claude/skills/markdown-memory. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the markdown-memory skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.