memory-metadata-search

SKILL.md

Memory Metadata Search

Find notes by their structured frontmatter fields instead of (or in addition to) free-text content. Any custom YAML key in a note's frontmatter beyond the standard set (title, type, tags, permalink, schema) is automatically indexed as entity_metadata and becomes queryable.

When to Use

Filtering by status or priority — find all notes with status: draft or priority: high

Querying custom fields — any frontmatter key you invent is searchable

Range queries — find notes with confidence > 0.7 or score between 0.3 and 0.8

Combining text + metadata — narrow a text search with structured constraints

Tag-based filtering — find notes tagged with specific frontmatter tags

Schema-aware queries — filter by nested schema fields using dot notation

The Tool

All metadata searching uses search_notes. Pass filters via metadata_filters, or use the tags and status convenience shortcuts. Omit query (or pass None) for filter-only searches.

Filter Syntax