memory-okf — Claude Code skill: OKF export prep
memory-okf — a skill for Claude Code that finds and fixes blockers to exporting a Basic Memory project as OKF v0.2. It runs before publishing, handing off a project, or checking an export bundle.
AGPL-3.0 305 installs ★ 4,660 updated 2026-10-24
npx skills add basicmachines-co/basic-memory --skill memory-okf -a claude-codeWhat memory-okf does
The skill checks a Basic Memory project for export blockers, including notes with unsuitable file extensions, user notes named index.md or log.md, and conflicting metadata. It renames notes with bm_move, preserving their links, and leaves wiki pages for the projector to manage.
Local export and bundle checks require the bm CLI. In Basic Memory Cloud, export runs as a cloud task. The bm okf check command validates bundle structure but accepts broken cross-links. Wikilinks stay in the project; export converts them to Markdown links.
What it helps with
- find notes ending in
.markdownor.MD - rename user notes that occupy the
index.mdorlog.mdnames - remove conflicting
bm.okf_exportmetadata - check an OKF bundle or run a local export
Example prompts for the agent
- Prepare this Basic Memory project for OKF v0.2 export and fix the blockers.
- Check the OKF bundle in
~/exports/research. - Get this project ready for handoff and list the notes you renamed.
How to install memory-okf
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-okf -a claude-code2Manually: put the files in place
~/.claude/skills/memory-okf/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/memory-okf/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-okf -a codex2Manually: put the files in place
.agents/skills/memory-okf/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-okf -a cursor2Manually: put the files in place
.cursor/skills/memory-okf/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install basicmachines-co/basic-memory skills/memory-okf2Manually: put the files in place
.github/skills/memory-okf/SKILL.md1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-okf -a gemini-cli2Platform CLI
gemini skills install https://github.com/basicmachines-co/basic-memory --path skills/memory-okfManually: put the files in place
.devin/skills/memory-okf/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-okf -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-okf
How do I install memory-okf in Claude Code?
Run npx skills add basicmachines-co/basic-memory --skill memory-okf -a claude-code. The skill file is located at ~/.claude/skills/memory-okf/SKILL.md.
What does memory-okf do?
It checks a Basic Memory project for problems that block an OKF v0.2 export, then fixes issues with note names and metadata. It can also check an exported bundle.
What does memory-okf need to run?
It needs a Basic Memory project. Local exports and bundle checks require the bm CLI; Basic Memory Cloud runs exports as cloud tasks.