Skip to main content
skill CX Codex

memory-tasks — Claude Code skill: tasks that survive context

Keeps work-in-progress as notes in the Basic Memory knowledge graph, so you can find active tasks and resume them after compaction or a restart.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add basicmachines-co/basic-memory --skill memory-tasks -a claude-code
Open on GitHub

What memory-tasks does

This skill stores tasks as notes with type: Task. They sit in the Basic Memory knowledge graph, are checked against the schema/Task.md schema, and outlive context compaction. Fields such as status, assigned_to, current_step and steps go into both metadata and observations: metadata drives bm_search filters, observations drive bm_schema(command="validate").

A task is created with bm_write using note_type="Task" and a metadata block. The body carries Observations, a Steps list with checkboxes, and a Context section. Write that context as if explaining the work to someone who knows nothing about it — file paths, decisions already made, what you tried. After a session is compacted, the skill searches for active tasks with bm_search(note_types=["task"], filters={"status": "active"}) and picks up from current_step.

Before editing, read the task as JSON and pass its checksum as expected_checksum. Two sessions often touch the same task, for instance during a pre-compaction flush. A revision conflict means the other session wrote first, so re-read before writing. The skill advises one task per unit of work and closing finished ones instead of leaving them active.

What it helps with

  • open a task for multi-step work and keep it across context compaction
  • find active tasks after a restart and resume from the right step
  • write down context before compaction so the work is not lost
  • filter tasks by status, assignee or blockers
  • validate tasks against the schema and spot drift in the notes

Example prompts for the agent

  • Create a task for refactoring the auth module, three steps, status active
  • Find all active tasks and resume from the current step
  • Update the context of active tasks before compaction

How to install memory-tasks

1Skills CLI (Vercel)

npx skills add basicmachines-co/basic-memory --skill memory-tasks -a claude-code

2Manually: put the files in place

~/.claude/skills/memory-tasks/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/memory-tasks/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about memory-tasks

How do I install memory-tasks in Claude Code?

Run npx skills add basicmachines-co/basic-memory --skill memory-tasks -a claude-code. The skill lands in ~/.claude/skills/memory-tasks/SKILL.md.

What does memory-tasks do?

It manages tasks as Basic Memory notes with type: Task: creates them via bm_write, updates steps and context, and finds active ones with bm_search. Tasks stay reachable after context compaction.

Why do I get a revision conflict when updating a task?

Two sessions can edit the same task at once, for example during a pre-compaction flush. A conflict means the other session wrote first — re-read the note and retry with the fresh checksum.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set14

memory-research Researches companies, people, and tools across the web and synthesizes findings into Basic Memory notes. Useful when you need to record structured facts about an external subject. CX Codex +1 1,200installs memory-literary-analysis Turns a complete literary work into a Basic Memory knowledge graph with schemas, chapter notes, linked entities, and validation. CX Codex +1 1,200installs memory-lifecycle Automates note status transitions in Basic Memory. It archives completed work into appropriate folders and updates frontmatter without deleting records. CX Codex +1 1,200installs memory-defrag This skill tidies a Basic Memory project by splitting bloated notes, consolidating facts, and flagging contradictions for review. CX Codex +1 1,200installs memory-schema Manages note schemas in Basic Memory by finding untyped entries, generating schema definitions, checking field consistency, and catching structural drift. CX Codex +1 1,200installs memory-metadata-search Search Basic Memory notes by YAML frontmatter fields, from status and tags to nested values. Useful when a text query alone cannot narrow the results. CX Codex +1 1,200installs memory-reflect The skill reviews what changed in Basic Memory and carries the durable parts into the notes where they belong. Run it daily or after a burst of work. CX Codex +1 1,200installs memory-onboarding Guides you through designing a Basic Memory knowledge base and wiring it into your assistant so project context persists across sessions. CX Codex +1 960installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor