bmad-distillator

Compress source documents into lossless token-efficient distillates for LLM consumption.

2|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/Wizarck/nexandro --skill bmad-distillator-wizarck
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-distillator
Source: https://github.com/Wizarck/nexandro/tree/main/skills/bmad-distillator
Command: npx skills add https://github.com/Wizarck/nexandro --skill bmad-distillator-wizarck

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Feeding large sets of source documents (product briefs, discovery notes, research reports) into downstream LLM workflows wastes tokens on prose, transitions, and repetition, while naive summarization loses critical facts, decisions, and constraints. ## Core Features & Use Cases - Lossless Compression: Extracts every fact, decision, constraint, and relationship from source documents into dense, thematically-grouped bullet distillates with no information loss. - Semantic Splitting: Automatically splits large distillates into self-contained section files with an index when content exceeds token budgets. - Round-Trip Validation: Optionally reconstructs original documents from the distillate alone and diffs them to prove completeness, flagging gaps and hallucinations. - Use Case: Before writing a PRD, distill a product brief plus its discovery notes into a single ~1,500-token distillate that the PRD workflow consumes as sole context input. ## Quick Start Distill the documents in my planning folder into a single context file for PRD creation and run the validation check.

Frequently Asked Questions about bmad-distillator

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

FAQPage Schema
How do I compress documents for LLM context without losing information?▼

Use distillation rather than summarization: extract every fact, decision, and constraint, deduplicate across sources, and format as dense thematic bullets. This skill automates that process and verifies completeness against source headings and named entities.

What is the difference between a distillate and a summary?▼

Summaries are lossy and drop details for readability. A distillate is lossless compression: it preserves every fact, number, decision, and open question while stripping only prose overhead like transitions, hedging, and repeated introductions.

How do I handle documents too large for a single context file?▼

When content exceeds roughly 5,000 tokens or a specified token budget, the distillate is split semantically into a folder with an index file plus self-contained section files, each loadable independently by downstream workflows.

Can I verify that no information was lost during compression?▼

Yes, the --validate flag runs round-trip validation: a separate agent reconstructs the original documents from the distillate alone, then a semantic diff against the originals produces a report listing gaps and hallucinations.

What file formats can be distilled?▼

The analysis script accepts Markdown, text, YAML, and JSON files via file paths, folder paths, or glob patterns, skipping directories like node_modules and .git during recursive scans.