memory · makushingu — Claude Code skill: what it does and how to install
memory is a Claude Code skill that saves lasting facts to the appropriate memory file after a substantial exchange. It handles decisions, preferences, and project changes, while skipping one-off questions.
no license ★ 285 updated 2026-11-17
npx skills add makushingu/harness-maxxing --skill memory -a claude-codeWhat memory does
memory chooses a storage level for each fact: agent, topic, project, or the whole workspace. It keeps brief notes on decisions, user preferences, work status, and reusable details such as paths or commands.
Keep notes short and replace facts that have changed rather than preserving conflicting versions. Longer material, such as test steps, can live in a nearby report with a path recorded in memory. Secrets must stay out of memory; record only the name of a key.
For Claude Code, run npx skills add makushingu/harness-maxxing --skill memory -a claude-code. The skill file is at ~/.claude/skills/memory/SKILL.md.
What it helps with
- save a decision made during a discussion
- record a user's preference or working rule
- note a project's current state and next step
- keep a reusable path or command for later sessions
Example prompts for the agent
- Record the decision to use
PostgreSQLin the project memory. - Save my rule that new tests belong next to the code.
- Note that the task is blocked until the API update.
How to install memory
1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill memory -a claude-code2Manually: put the files in place
~/.claude/skills/memory/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/memory/
1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill memory -a codex2Manually: put the files in place
.agents/skills/memory/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill memory -a cursor2Manually: put the files in place
.cursor/skills/memory/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install makushingu/harness-maxxing skills/memory2Manually: put the files in place
.github/skills/memory/SKILL.md1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill memory -a gemini-cli2Platform CLI
gemini skills install https://github.com/makushingu/harness-maxxing --path skills/memoryManually: put the files in place
.devin/skills/memory/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about memory
How do I install memory in Claude Code?
Run npx skills add makushingu/harness-maxxing --skill memory -a claude-code. The skill file is at ~/.claude/skills/memory/SKILL.md.
What does memory do?
It saves durable details from substantial exchanges to a suitable memory file, so they can carry over to later sessions.
How does memory choose where to save a fact?
It uses the narrowest applicable scope: agent, topic, project, or workspace. A fact that applies across the whole workspace belongs in global memory.
Similar skills
All skills for Agent setup: memory, context, orchestration →memory by other authors comes first.