{"id":47663604,"url":"https://github.com/basicmachines-co/basic-memory-skills","last_synced_at":"2026-04-02T11:47:42.246Z","repository":{"id":338490263,"uuid":"1158076319","full_name":"basicmachines-co/basic-memory-skills","owner":"basicmachines-co","description":"OpenClaw skills for AI memory management — reflection, defragmentation, and more","archived":false,"fork":false,"pushed_at":"2026-03-05T20:57:53.000Z","size":80,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-05T23:41:50.391Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/basicmachines-co.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-14T18:57:34.000Z","updated_at":"2026-03-05T20:57:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/basicmachines-co/basic-memory-skills","commit_stats":null,"previous_names":["basicmachines-co/basic-memory-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/basicmachines-co/basic-memory-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basicmachines-co%2Fbasic-memory-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basicmachines-co%2Fbasic-memory-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basicmachines-co%2Fbasic-memory-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basicmachines-co%2Fbasic-memory-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/basicmachines-co","download_url":"https://codeload.github.com/basicmachines-co/basic-memory-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basicmachines-co%2Fbasic-memory-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31305809,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T09:48:21.550Z","status":"ssl_error","status_checked_at":"2026-04-02T09:48:19.196Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-02T11:47:41.406Z","updated_at":"2026-04-02T11:47:42.236Z","avatar_url":"https://github.com/basicmachines-co.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# basic-memory-skills\n\nSkills for [Basic Memory](https://github.com/basicmachines-co/basic-memory) — teach AI coding agents how to use Basic Memory's MCP tools effectively.\n\n## What Are Skills?\n\nSkills are markdown instruction files (`SKILL.md`) that AI agents load for domain-specific guidance. Each skill contains structured knowledge about *when* and *how* to use specific tools, with examples and best practices.\n\nBasic Memory provides the MCP server — tools like `write_note`, `search_notes`, and `build_context` for managing a local-first knowledge graph. These skills teach agents how to use those tools well: when to create tasks vs. notes, how to structure observations for searchability, when to run schema validation, and more.\n\n## Skills\n\n| Skill | Description | When to use |\n|-------|-------------|-------------|\n| **memory-tasks** | Structured task tracking that survives context compaction. Creates typed `Task` notes with steps, status, and context. | Multi-step work (3+ steps), anything that might outlast a context window, or after compaction to resume. |\n| **memory-schema** | Schema lifecycle management — discover unschemaed notes, infer schemas, create/edit definitions, validate, and detect drift. | When structured note types emerge (Task, Person, Meeting, etc.) and you want consistency. |\n| **memory-reflect** | Sleep-time memory reflection. Reviews recent conversations and daily notes, extracts insights, consolidates into long-term memory. Inspired by [sleep-time compute](https://www.letta.com/blog/sleep-time-compute). | Schedule via cron (1-2x daily), trigger from heartbeat, or run on demand. |\n| **memory-notes** | How to write well-structured notes — frontmatter, observations with semantic categories, relations with wiki-links, and best practices. | When creating or improving notes, or when you need a reference for the note format. |\n| **memory-metadata-search** | Structured metadata search — query notes by custom frontmatter fields using equality, range, array, and nested filters. | When finding notes by status, priority, confidence, or any custom YAML field. |\n| **memory-defrag** | Memory defragmentation — split bloated files, merge duplicates, remove stale information, restructure the hierarchy. | Run weekly/biweekly via cron, or on demand when memory feels messy. |\n| **memory-lifecycle** | Entity lifecycle management — status transitions through folder-based organization, archiving completed work. Core principle: archive, never delete. | When marking items complete, archiving old entities, or managing folder-based status workflows. |\n| **memory-ingest** | Process unstructured external input into structured entities. Parses meeting transcripts, conversation logs, and pasted documents. | When pasting a transcript, conversation log, or external document that should become structured knowledge. |\n| **memory-research** | Web research synthesized into Basic Memory entities. Researches a subject, checks for existing knowledge, presents findings, and creates entity notes. | When asked to research a company, person, technology, or topic. |\n| **memory-literary-analysis** | Analyze a complete literary work into a structured knowledge graph — characters, themes, chapters, locations, symbols, and literary devices. | Full-text literary analysis, book club companions, teaching resources, or research projects. |\n\n## Basic Memory Cloud\n\nEverything works locally — cloud adds cross-device, team, and production capabilities:\n\n- **Your agent's memory travels with you** — same knowledge graph on laptop, desktop, and hosted environments\n- **Team knowledge sharing** — org workspaces let multiple agents and team members build on a shared knowledge base\n- **Durable memory for production agents** — persistent memory that survives CI teardowns and container restarts\n- **Multi-agent coordination** — multiple agents can read and write to the same graph\n\nCloud extends local-first — still plain markdown, still yours. Start with a [7-day free trial](https://basicmemory.com) and use code `BMFOSS` for 20% off for 3 months.\n\n## Installation\n\n### Via npx skills (recommended)\n\nInstall or update skills using the [Skills CLI](https://github.com/vercel-labs/skills):\n\n```bash\n# Install all skills\nnpx skills add basicmachines-co/basic-memory-skills\n\n# Install a specific skill\nnpx skills add basicmachines-co/basic-memory-skills --skill memory-tasks\n\n# Install all skills for a specific agent\nnpx skills add basicmachines-co/basic-memory-skills --agent claude\n\n# List available skills without installing\nnpx skills add basicmachines-co/basic-memory-skills --list\n\n# Check for updates\nnpx skills check\n\n# Update installed skills\nnpx skills update\n```\n\nSkills are installed to your agent's skills directory (e.g., `~/.claude/skills/` for Claude Code global, or `.claude/skills/` for project-scoped).\n\n### Claude Desktop (claude.ai)\n\nClaude Desktop loads skills through **Settings \u003e Capabilities**:\n\n1. Clone or download this repository\n2. In Claude, go to **Settings \u003e Capabilities** and ensure both **Code execution** and **Skills** are enabled\n3. Click **Upload skill** and upload the `SKILL.md` file (or ZIP the skill folder and upload that)\n4. Toggle the skill on — Claude will use it automatically when relevant\n\nRepeat for each skill you want. Custom uploaded skills are private to your account.\n\n\u003e **Tip:** Start with **memory-notes** (core note-writing patterns) and add others as needed. You don't need all 9 at once.\n\nSee [Using Skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude) for more details.\n\n### Manual install\n\nCopy skill directories into your agent's skills folder:\n\n```bash\n# Claude Code — global\ncp -r memory-tasks ~/.claude/skills/\ncp -r memory-notes ~/.claude/skills/\n# ... etc.\n\n# Claude Code — project-scoped\ncp -r memory-tasks .claude/skills/\n\n# Any agent that reads SKILL.md files\ncp -r memory-tasks \u003cagent-skills-dir\u003e/\n```\n\n### Bundled with OpenClaw plugin\n\nAll 9 skills are also bundled in the [`@basicmemory/openclaw-basic-memory`](https://github.com/basicmachines-co/openclaw-basic-memory) plugin — no extra install step needed if you use OpenClaw.\n\n## Compatible Agents\n\nThese skills work with any AI coding agent that supports the SKILL.md format:\n\n- **Claude Desktop** — upload skill ZIPs via Settings \u003e Capabilities\n- **Claude Code** — loads skills from `~/.claude/skills/` or `.claude/skills/`\n- **Cursor** — AI-powered coding with skill support\n- **Windsurf** — agent-based development with skill loading\n- **Any agent** supporting markdown-based skill files\n\n## Development\n\nSee [DEVELOPMENT.md](./DEVELOPMENT.md) for testing and contribution details.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbasicmachines-co%2Fbasic-memory-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbasicmachines-co%2Fbasic-memory-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbasicmachines-co%2Fbasic-memory-skills/lists"}