fmql

Query and bulk-edit YAML frontmatter across Markdown files.

17|1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/buyuk-dev/fmql --skill fmql
Or copy as Structured Prompt for Agent
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.