basicmachines-co/basic-memory
25 skills5.5k installs89.5k starsGitHub
Install
npx skills add https://github.com/basicmachines-co/basic-memorySkills in this repo
1Memory NotesMemory Notes explains how to write Basic Memory notes that parse into a searchable knowledge graph. A developer uses it so an agent creates notes with correct frontmatter, categorized observations, and wiki-link relations instead of unstructured text. It covers the write_note and edit_note tools, memory:// URLs, and the practice of searching before creating to avoid duplicates.327installs2Memory CaptureThis skill captures the current state of a working thread or conversation into a single coherent Basic Memory note. It synthesizes decisions, insights, and context into one document rather than an append-only log, and on re-capture rewrites the same note in place. A developer uses it mid-thread or end-of-thread to preserve decisions before a session closes.325installs3Memory CurateThis skill curates the Basic Memory knowledge graph as notes accumulate. It finds orphan notes and suggests links, proposes typed relations, merges or differentiates duplicates, audits tags and folders, and builds hub notes. A developer uses it to organize and connect a knowledge base so isolated notes become a connected graph.325installs4Memory ContinueThis skill resumes prior work by reconstructing context from the Basic Memory knowledge graph instead of starting cold. It navigates the graph with build_context, recent_activity, and search_notes, following relations and memory:// URLs to surface the current state, recent changes, and open items. A developer uses it when starting a session or asking to pick up where they left off.324installs5Memory TasksMemory Tasks manages work-in-progress using Basic Memory's schema system, storing tasks as notes with type Task. A developer uses it so an agent can create multi-step tasks, track them by status and current_step, and resume them after context compaction. It puts queryable fields in both frontmatter and observations and includes a pre-compaction flush to save state before context is lost.317installs6Memory ReflectMemory Reflect is a background routine that reviews recent Basic Memory activity and consolidates valuable insights into long-term memory. A developer schedules it on a cron or heartbeat so an agent distills decisions, lessons, and preferences from daily notes into a curated MEMORY.md. It uses recent_activity, read_note, and search_notes, then logs a short reflection entry.315installs7Memory Metadata SearchMemory Metadata Search lets an agent find Basic Memory notes by their structured YAML frontmatter fields rather than by free-text content. A developer uses it to filter notes by status, priority, type, confidence thresholds, or any custom frontmatter key. It runs through the search_notes tool with a metadata_filters JSON dictionary that supports equality, ranges, arrays, and nested access.314installs8Memory SchemaMemory Schema manages the lifecycle of structured note types in Basic Memory using its Picoschema system. A developer uses it to define schemas for types like Task, Person, or Meeting, then validate notes and detect drift so the knowledge graph stays consistent. It covers schema_infer, schema_validate, and schema_diff, plus versioning rules for additive versus breaking changes.313installs9Memory DefragThis skill defragments and reorganizes an agent's memory files: splitting bloated files, merging duplicates, removing stale entries, and restructuring the hierarchy. It audits current state, plans changes, executes them one at a time, and logs the result while preserving raw daily notes. A developer runs it periodically or when MEMORY.md grows unwieldy.312installs10Memory IngestThis skill turns raw, unstructured input such as meeting transcripts, conversation logs, or pasted documents into structured Basic Memory entities. It extracts entities, cross-references them against existing knowledge, proposes new entities for approval, then creates a verbatim source note plus structured notes with observations, relations, and action items. A developer uses it to convert external text into a connected knowledge graph.310installs11Memory LifecycleThis skill manages how entities move through status stages in Basic Memory, such as archiving completed work or reactivating archived items. It follows an archive-never-delete principle: it moves notes between status folders, updates frontmatter, and preserves everything in the knowledge graph. A developer uses it when marking items complete or managing a folder-based status workflow.309installs12Memory Literary AnalysisThis skill transforms a complete literary work into a structured Basic Memory knowledge graph. Characters, themes, chapters, locations, symbols, and literary devices become interconnected, searchable, and visualizable notes. It runs a six-phase pipeline from schema design through chapter processing, cross-referencing, validation, and canvas visualization. Developers use it for study resources or to stress-test Basic Memory at scale.308installs13Memory ResearchMemory Research directs an agent to research an external subject with web search, synthesize the findings, and create a structured Basic Memory entity. A developer uses it to turn a company, person, technology, or topic into a knowledge-graph note. It follows a fixed workflow: search the web, check existing memory, present a hedged summary with sources, and create the entity only after user approval.308installs14Memory Ci CaptureThis skill runs in CI after `bm ci collect` prepares a ProjectUpdateContext, turning a GitHub delivery moment such as a merged PR or production deploy into a concise Basic Memory project update. It returns only structured AgentSynthesis JSON for `bm ci publish` and never invents tests, checks, or decisions. It records what changed and why for future humans and agents.286installs15Adversarial ReviewThis skill runs a cross-vendor adversarial code review of the current branch diff. Claude and Codex/GPT each review independently, then try to refute each other's findings, and survivors are reported by confidence. A developer uses it to get high-confidence findings before merging without auto-applying any fixes.134installs16Bm RememberThis skill captures a thought, fact, or reminder into Basic Memory as a lightweight note. A developer uses it when they say remember that, note this, or save this to memory for quick deliberate capture. It keeps the user's exact wording, derives a title from the first line, and writes the note with write_note into the configured remember folder and project.131installs17Bm SetupThis skill configures the Basic Memory plugin for a project through a short adaptive interview. A developer runs it to map the project to a Basic Memory project, seed note schemas, learn or suggest folder placement conventions, and enable capture reflexes. It verifies the Basic Memory MCP server is connected first and does no writes until the plan is confirmed.129installs18Bm StatusThis skill reports the Basic Memory plugin's current state for a project as a quick diagnostic. A developer runs it to see the active project, capture folders, output style, recent session checkpoints, active task count, and whether the CLI is reachable. It gathers the facts and lays them out in a concise summary without over-investigating.128installs19Bm ShareThis skill copies a note from your personal Basic Memory project into a configured shared team project with attribution. A developer uses it to publish a decision or note to teammates when they say share this with the team. It is the only path that writes to a team workspace, keeps frontmatter, adds a shared_from field, and asks for confirmation before the visible write.127installs20InfographicsThis skill generates repository visuals (PR, changelog, release, and 2-week weekly images) grounded in evidence from the PR body or a changelog evidence pack. It runs an image-generation script that produces image-first editorial scenes and writes them to canonical webp paths. A developer uses it to attach visuals to PRs and releases without hand-writing claims not present in the source.108installs21Fix Pr IssuesThis skill addresses pull request feedback, failed GitHub Actions checks, and BM Bossbot blockers for Basic Memory. It builds a short issue ledger, fixes items one at a time with narrow diffs, pushes, and waits for the BM Bossbot Approval status on the new head SHA. It never merges the PR itself.107installs22Code ReviewThis skill runs a code-review pass on a diff or named files for the Basic Machines repos (basic-memory, basic-memory-cloud). It applies the repo's house-style and architecture rules, then reports only concrete, falsifiable risks ordered by severity. A developer uses it before merging a change to check boundary direction, accidental complexity, and test quality.106installs23Pr CreatePR Create creates or updates a Basic Memory pull request from Codex and then waits for the BM Bossbot merge-gate to approve the current head SHA. A developer uses it to push a feature branch, create or reuse a PR with a semantic title, and watch the required approval status. It runs preflight checks on branch, GitHub auth, and sign-offs, and it never merges the PR.106installs24InstrumentationThis skill adds Pydantic Logfire observability to an application, capturing traces, logs, and metrics via OpenTelemetry. It detects the language and frameworks, installs the right extras, and enforces the correct configure/instrument ordering so traces are not silently dropped. Developers use it when adding tracing, structured logging, or LLM monitoring to Python, JS/TS, or Rust code.3installs25Basic Memorybasic-memory is a Claude Code skill and plugin that bridges Claude's ephemeral working memory to Basic Memory's local-first markdown knowledge graph. Developers install it when sessions keep losing architecture decisions, task context, or research across compactions and new chats. Hooks deliver session-start briefings and pre-compaction checkpoints, while slash commands set up projects and capture durable notes searchable via the Basic Memory MCP server.0installs