bmad-distillator

Compress source documents into token-efficient distillates with structured bullets.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Distillator provides lossless, token-efficient compression of source documents, enabling downstream LLM workflows to access complete context with minimal tokens.

Core Features & Use Cases

  • Lossless compression: preserves facts, decisions, constraints, and relationships.
  • Supports single or multi-file distillation with routing, semantic splitting, and cross-document coherence.
  • Suitable for product briefs, discovery notes, architecture docs, research reports, and PRDs; ideal when distilling large source sets into a single consumable input.

Quick Start

Run the distillator to distill source documents at INPUT_PATHS into a single distillate file, optionally specifying an output path and token budget.

Frequently Asked Questions about bmad-distillator

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

FAQPage Schema
How do I compress multiple source documents into a single token-efficient file for LLM workflows?

Document distillation compresses multiple source documents into a compact, token-efficient distillate file. The process preserves facts, decisions, and relationships while routing and semantically splitting content across files to maintain cross-document coherence.

What is lossless distillation and when do I need it for document management?

Lossless distillation is the compression of source documents into compact outputs without losing facts, decisions, or constraints. It is needed when preparing large product briefs, architecture docs, or research reports as single consumable inputs for downstream LLM workflows.

Can I distill PRDs and architecture docs together while maintaining cross-document coherence?

Yes, distillation supports multi-file processing with semantic splitting and routing. It maintains cross-document coherence across PRDs, architecture docs, and discovery notes, ensuring relationships and constraints are preserved in the final distillate.

How do I set a token budget when distilling source documents for downstream LLM consumers?

You can specify a token budget as an optional parameter when running the distillation process. The distillator uses this budget to compress the source documents list into a distillate with frontmatter and structured bullets tailored for the downstream consumer.

What is the best way to prepare large research reports as a single consumable input for LLM processing?

Distilling large research reports into a single compact distillate is the best approach for LLM consumption. This lossless compression outputs a file with frontmatter and structured bullets, preserving complete context while minimizing tokens.

Does distillation work with single files or does it require multiple source documents?

Distillation works with both single and multi-file source sets. You provide a source documents list at an input path, and the distillator processes it into a single distillate file, optionally allowing you to specify an output path and token budget.