mdbase

Manage typed Markdown collections with YAML frontmatter schemas and querying.

5|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/oldwinter/skills --skill mdbase-oldwinter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mdbase
Source: https://github.com/oldwinter/skills/tree/main/obsidian-skills/mdbase
Command: npx skills add https://github.com/oldwinter/skills --skill mdbase-oldwinter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines the management of structured data within Markdown files, turning collections of documents into a queryable, typed database without external dependencies.

Core Features & Use Cases

  • Typed Data Management: Define schemas for your Markdown records using YAML frontmatter and type definitions.
  • Querying and Validation: Efficiently query your data using a powerful expression language and validate records against defined schemas.
  • Use Case: Organize project documentation, knowledge bases, or product catalogs where each item (e.g., a feature, a bug report, a user story) has a defined structure and needs to be easily searched and maintained.

Quick Start

Use the mdbase skill to validate the collection in the current directory.

Frequently Asked Questions about mdbase

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

FAQPage Schema
How do I query markdown files with YAML frontmatter?

You can query markdown files with YAML frontmatter by defining typed schemas and using a robust expression language to filter and sort complex data structures within your document collections.

Can I validate markdown records against a defined schema?

Yes, you can validate markdown records against defined schemas using type definitions and YAML frontmatter, ensuring your structured data conforms to specified rules without external dependencies.

What is the best way to manage structured data in markdown collections?

Managing structured data in markdown collections is best achieved by turning documents into a typed database, enabling schema definition, data validation, and querying directly within the files.

How do computed fields and inheritance work in markdown data management?

Computed fields and inheritance in markdown data management allow complex data structures to derive values automatically and extend base schemas, enabling dynamic and maintainable typed document collections.

Do I need external databases to organize a markdown knowledge base?

No, you do not need external databases to organize a markdown knowledge base, because this approach transforms collections of documents into a queryable, typed database natively without external dependencies.

Does this typed markdown querying work with AI tools?

Yes, typed markdown querying integrates with various AI tools via the Agent Skills standard and provides adapter files, ensuring broader compatibility and seamless interaction within AI-driven workflows.