memory-metadata-search

Search notes by structured frontmatter fields using metadata filters.

25|3|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/basicmachines-co/basic-memory-skills --skill memory-metadata-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-metadata-search
Source: https://github.com/basicmachines-co/basic-memory-skills/tree/main/memory-metadata-search
Command: npx skills add https://github.com/basicmachines-co/basic-memory-skills --skill memory-metadata-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows you to efficiently locate notes based on their structured frontmatter fields, rather than relying solely on free-text content searches.

Core Features & Use Cases

  • Query by Custom Fields: Search notes using any YAML key defined in their frontmatter.
  • Advanced Filtering: Supports equality, range, array containment, and nested field queries.
  • Use Case: Quickly find all 'spec' type notes with a 'high' priority and a 'confidence' score above 0.7.

Quick Start

Find all notes with the status 'in-progress' using metadata filters.

Frequently Asked Questions about memory-metadata-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search notes by frontmatter metadata instead of text content?

You can search notes by frontmatter metadata using the search_notes tool with metadata_filters. This allows you to locate notes based on structured YAML fields rather than relying solely on free-text content searches.

Can I filter notes by range comparisons and nested fields in frontmatter?

Yes, filtering notes by frontmatter supports equality, range comparisons, array containment, and nested field access via dot notation. This enables precise queries like finding high priority notes with confidence scores above 0.7.

What's the best way to find all notes with a specific status in frontmatter?

The best way to find notes with a specific status is using metadata_filters with an equality condition on the status field. For example, you can quickly locate all notes marked as in-progress by querying that custom YAML key.

Do I need predefined schemas to query custom YAML keys in notes?

No, you do not need predefined schemas to query custom YAML keys. The metadata search handles custom YAML frontmatter keys automatically, allowing flexible querying across any structured fields defined in your notes.

Does frontmatter metadata search work with array containment checks?

Yes, frontmatter metadata search works with array containment checks. You can filter notes by checking if a specific value exists within an array field defined in the YAML frontmatter.

Why use metadata filtering instead of full-text search for notes?

Metadata filtering is used instead of full-text search when you need to efficiently locate notes based on structured frontmatter fields. It provides precise filtering by custom fields, which is more accurate than relying on content keywords.