memory-lifecycle · basicmachines-co — Claude Code skill: archive notes, keep links
A Basic Memory skill that moves notes between status folders, updates frontmatter, and archives instead of deleting.
npx skills add basicmachines-co/basic-memory-skills --skill memory-lifecycle -a claude-codeWhat memory-lifecycle does
This skill handles status transitions for entities in Basic Memory. Say that something is done, cancelled or on hold, and it locates the note, moves the file into a folder like archive/ or completed/, then updates the status field in frontmatter. The order matters: move_note runs first, edit_note second. If the edit fails, the file is already in the right place.
Archive, never delete — that is the rule the skill follows. Deleting a note drops it from the knowledge graph along with its observations and relations, so the skill reserves deletion for typos and real duplicates. Permalinks survive a move, which means [[wiki-links]] and memory:// URLs keep resolving. Reverting a mistaken archive is the same move in reverse.
Some status changes need no move at all. Paused or blocked items stay in active/ with only a frontmatter edit. When several notes match a request, or the target folder is unclear, the skill asks instead of guessing. Folder names come from your own structure, so a clear status scheme pays off before you start.
What it helps with
- move a finished task into
completed/without breaking its links - bring back a note that was archived by mistake
- sync the frontmatter status after relocating a file
- clean up stale active notes that are no longer relevant
- tell a partially finished item apart from a closed one
Example prompts for the agent
- The quarterly report is done, archive it
- I closed the migration task by accident — move it back to active
- Go through my active notes and tell me what should be archived
How to install memory-lifecycle
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory-skills --skill memory-lifecycle -a claude-code2Manually: put the files in place
~/.claude/skills/memory-lifecycle/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/memory-lifecycle/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory-skills --skill memory-lifecycle -a codex2Manually: put the files in place
.agents/skills/memory-lifecycle/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory-skills --skill memory-lifecycle -a cursor2Manually: put the files in place
.cursor/skills/memory-lifecycle/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install basicmachines-co/basic-memory-skills memory-lifecycle2Manually: put the files in place
.github/skills/memory-lifecycle/SKILL.md1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory-skills --skill memory-lifecycle -a gemini-cli2Platform CLI
gemini skills install https://github.com/basicmachines-co/basic-memory-skills --path memory-lifecycleManually: put the files in place
.devin/skills/memory-lifecycle/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory-skills --skill memory-lifecycle -a opencodeClaude.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-lifecycle
How do I install memory-lifecycle in Claude?
Run npx skills add basicmachines-co/basic-memory-skills --skill memory-lifecycle -a claude-code. The skill lands in ~/.claude/skills/memory-lifecycle/SKILL.md.
What does memory-lifecycle do?
It manages status transitions in Basic Memory: moving notes between folders, editing frontmatter, and handling edge cases such as an entity that is already archived.
Does archiving delete my notes?
No. The skill moves the file rather than removing it, so observations, relations and history stay in the knowledge graph. Deletion is limited to typos and duplicates.
Similar skills
All skills for Agent setup: memory, context, orchestration →memory-lifecycle by other authors comes first.