bmad-distillator

Compress source documents into lossless LLM-optimized distillates with optional semantic splitting.

36|16|Updated May 1, 2026
One-click install
npx skills add https://github.com/tronghieu/lumina-wiki --skill bmad-distillator-tronghieu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-distillator
Source: https://github.com/tronghieu/lumina-wiki/tree/main/.agents/skills/bmad-distillator
Command: npx skills add https://github.com/tronghieu/lumina-wiki --skill bmad-distillator-tronghieu

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

It solves the problem of wasting context budget and token throughput when you need to feed multiple source documents into an LLM without losing facts, constraints, decisions, or relationships.

Core Features & Use Cases

  • Lossless compression (distillation): Produces hyper-compressed, token-efficient “distillates” that preserve every fact and relationship while removing human/LLM overhead.
  • Semantic splitting with token budget control: Automatically switches from a single dense distillate to a multi-part folder when content is large or exceeds a target budget.
  • Verification and optional round-trip validation: Performs completeness/format checks and can optionally reconstruct sources from the distillate for a losslessness test.
  • Use case: When you have a PRD pack, research notes, and architecture docs, generate one or several lossless LLM-ready context files for downstream PRD creation or design workflows.

Quick Start

Use the bmad-distillator skill to distill your project documents into a single dense distillate by providing source documents and an output path.

Frequently Asked Questions about bmad-distillator

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

FAQPage Schema
How do I compress source documents for LLM context without losing facts or constraints?

Document distillation compresses source materials into hyper-compressed, token-efficient distillates that preserve every fact and relationship while removing overhead. This process prepares lossless, LLM-optimized context files for downstream workflows like PRD creation or architecture design.

Can I split large documents semantically to fit a specific token budget for agent pipelines?

Yes, semantic splitting with token budget control automatically switches from a single dense distillate to a multi-part folder when content exceeds target thresholds. This approach manages token budgets by dividing distillates semantically by size for downstream agent pipelines.

How does lossless extraction verify that compressed distillates retain all original information?

Lossless extraction verifies distillates through completeness and format checks, and can optionally perform round-trip reconstruction validation. This semantic diff process reconstructs sources from the distillate to test whether all original facts and relationships are preserved.

What is the best way to prepare research notes and architecture docs for token-budgeted LLM workflows?

The best way to prepare multiple documents for token-budgeted pipelines is distillation, which runs analysis, compress, and verify stages to produce dense, LLM-ready context files. This ensures you maximize token throughput without losing critical constraints or decisions.

When should I use document distillation instead of feeding raw files directly into an LLM?

You should use document distillation when wasting context budget and token throughput is a concern, or when you need to feed multiple source documents into an LLM without losing facts. It is essential for information-extraction scenarios requiring strict token budget control.

Does the distillation process require any specific dependencies or external tools to run?

No, the distillation process requires no external dependencies, relying entirely on its internal scripts, references, and assets. You only need to provide the caller-provided source documents and an output path to generate the lossless distillate.