fmql

Query and bulk-edit YAML frontmatter across Markdown files.

17|1|Updated Apr 16, 2026

Search Tags:#markdown #yaml #query #frontmatter #traversal #bulk-edit #fmql

Ready to run

npx skills add https://github.com/buyuk-dev/fmql --skill fmql

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: fmql
Source: https://github.com/buyuk-dev/fmql/tree/main/packages/fmql/skills/fmql
Command: npx skills add https://github.com/buyuk-dev/fmql --skill fmql

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

fmql enables treating a directory of Markdown files with YAML frontmatter as a queryable, mutatable data set, removing the need for a fixed schema and letting you discover and manipulate structured metadata across many files.

Core Features & Use Cases

Query and filter based on frontmatter fields (strings, numbers, dates) across a repository.
Traverse file references within frontmatter (e.g., blocked_by, belongs_to) to reveal relationships and cycles.
Bulk-edit frontmatter across matched results, preserving comments and key order while applying changes.

Quick Start

Describe the workspace to learn its fields, then run a query to filter and bulk-edit frontmatter across the directory.

Frequently Asked Questions about fmql

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

FAQPage Schema

How do I bulk-edit YAML frontmatter across multiple Markdown files?▼

Bulk-edit YAML frontmatter across a directory of Markdown files by querying and filtering based on field values, then applying mutations to the matched set without requiring a fixed schema.

What is the best way to query Markdown frontmatter without a fixed schema?▼

Query Markdown frontmatter without a fixed schema by treating the directory as a queryable dataset, filtering by strings, numbers, and dates to discover structured metadata across files.

Can I traverse file references within frontmatter to find relationships?▼

Traverse file references within frontmatter fields like blocked_by or belongs_to to reveal relationships and detect cycles across the Markdown dataset.

Does bulk-editing frontmatter preserve comments, key order, and quoting?▼

Bulk-editing frontmatter preserves comments, key order, and quoting during edits, ensuring the original YAML formatting remains intact while applying mutations across matched files.

How do I filter Markdown files by frontmatter fields like dates and numbers?▼

Filter Markdown files by frontmatter fields by querying the directory and matching against strings, numbers, and dates, while exposing virtual properties like path and slug for advanced filtering.

When do I need to treat a directory of Markdown files as a dataset?▼

Treat a directory of Markdown files as a dataset when you need to query, filter, and manipulate structured metadata across many files simultaneously without enforcing a fixed schema.