Skip to main content
affpapa.org
RU EN
skill CX Codex

memory-metadata-search — Claude Code skill: 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.

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

What memory-metadata-search does

This skill lets you filter Basic Memory notes using their frontmatter. Match a field exactly, test a numeric range, check array values, or target a nested key. Multiple conditions are combined with AND, and custom YAML keys can be queried too.

Use bm_search for ranked matches or bm_find to locate files with selected fields. Filters can stand alone or narrow a text search. There’s a firm boundary: metadata filters apply to Markdown notes, so PDFs and images won’t appear as matches.

What it helps with

  • find notes by status or priority
  • select notes above a numeric threshold
  • filter by tags or nested YAML keys
  • narrow a text search with frontmatter conditions

Example prompts for the agent

  • Find notes whose status is draft and priority is high.
  • Show notes with confidence greater than 0.7.
  • Search for notes tagged security and oauth with active status.

How to install memory-metadata-search

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/memory-metadata-search/SKILL.md

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

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

Questions about memory-metadata-search

How do I install memory-metadata-search in Claude Code?

Run npx skills add basicmachines-co/basic-memory --skill memory-metadata-search -a claude-code. The skill file is at ~/.claude/skills/memory-metadata-search/SKILL.md.

What does memory-metadata-search do?

It searches Basic Memory notes using YAML frontmatter values, including custom fields. You can combine those filters with a text query.

Can it find PDFs by their metadata fields?

No. Metadata filters match Markdown notes; PDFs, images, and other regular files are not returned by these searches.

Similar skills

All skills for Notes, tasks and projects →
find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. CX Codex +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. 1,219,756installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. 1,038,491installs grilling Matt Pocock Stress-test a plan, decision, or idea through structured rounds of questions. Use it when you need to expose assumptions before acting. 979,543installs teach Matt Pocock Turns the current directory into a learning workspace and keeps progress across sessions. Use it when learning needs to support a concrete goal in your project. 862,247installs

From the same set14

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-tasks 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. 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-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 basic-memory A local MCP server that keeps your knowledge in Markdown files on disk and lets the AI read, write and search them. Useful when you are tired of re-explaining project context. CX Codex +1 ★ 4,357repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

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