bmad-distillator

Compress markdown, text, YAML, and JSON sources into lossless thematic distillates.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/GenEducation/GenedUIProject --skill bmad-distillator-geneducation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-distillator
Source: https://github.com/GenEducation/GenedUIProject/tree/main/.gemini/skills/bmad-distillator
Command: npx skills add https://github.com/GenEducation/GenedUIProject --skill bmad-distillator-geneducation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns one or more source documents into a lossless, token-efficient distillate so downstream LLM workflows can use a compact context window without losing facts, decisions, constraints, or relationships.

Core Features & Use Cases

  • Reads and compresses markdown, text, YAML, and JSON source sets into dense thematic bullets.
  • Preserves named entities, numbers, decisions, rejected alternatives, scope boundaries, open questions, risks, and dependencies while stripping filler.
  • Supports semantic splitting for large inputs, producing a root index plus self-contained section distillates when token budgets demand it.
  • Includes completeness checks and optional round-trip validation to reduce information loss.
  • Ideal for PRD creation, architecture design, research synthesis, and any workflow that needs a high-signal document handoff.

Quick Start

Ask the skill to distill the provided source documents into a lossless distillate for your downstream workflow.

Frequently Asked Questions about bmad-distillator

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

FAQPage Schema
How do I compress multi-file markdown and JSON documents into a compact LLM context window?

Distillation compresses multi-file markdown, text, YAML, and JSON sources into dense thematic bullets, preserving facts and decisions while stripping filler to reduce token usage. It applies thematic extraction and deduplication to create a high-signal, token-efficient distillate.

What is lossless document distillation for research synthesis workflows?

Lossless document distillation extracts key information from source documents into dense thematic bullets while preserving named entities, numbers, decisions, rejected alternatives, and dependencies. It ensures no critical facts are lost during compression, making it ideal for research synthesis and PRD creation.

Does semantic splitting work for large markdown inputs that exceed LLM token budgets?

Semantic splitting handles large inputs by producing a root index plus self-contained section distillates when token budgets demand it. This approach divides oversized documents into manageable sections, ensuring each distillate remains self-contained and contextually coherent.

How do I validate completeness after distilling source documents?

Completeness validation checks the distillate against source headings and named entities to reduce information loss. Optional round-trip validation further verifies that all critical facts, decisions, and constraints from the original documents are preserved in the compressed output.

Can I distill YAML and JSON configuration files alongside markdown for architecture design?

Yes, distillation reads and compresses markdown, text, YAML, and JSON source sets together into dense thematic bullets. This multi-format support allows architecture design workflows to consolidate structured configuration data and unstructured documentation into a single lossless distillate.

What is preserved during document compression for PRD creation workflows?

Document compression for PRD creation preserves named entities, numbers, decisions, rejected alternatives, scope boundaries, open questions, risks, and dependencies. It strips filler content while retaining all critical project requirements and constraints needed for downstream LLM workflows.