bmad-distillator

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

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/ncptuan/stock_backtest_project --skill bmad-distillator-ncptuan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-distillator
Source: https://github.com/ncptuan/stock_backtest_project/tree/main/.claude/skills/bmad-distillator
Command: npx skills add https://github.com/ncptuan/stock_backtest_project --skill bmad-distillator-ncptuan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill turns large sets of source documents into dense, token-efficient distillates that preserve facts, decisions, constraints, and relationships without collapsing into a lossy summary.

Core Features & Use Cases

  • Lossless Document Distillation: Compresses briefs, notes, specs, architecture docs, and related files into a compact format optimized for downstream LLM workflows.
  • Analysis, Routing, and Semantic Splitting: Analyzes file sets, recommends single-pass or fan-out compression, and splits large outputs into self-contained topical sections when needed.
  • Verification and Round-Trip Validation: Checks completeness against headings and named entities, measures compression ratio, and can optionally reconstruct source documents to validate information preservation.
  • Use Case: Use it when you need to convert a folder of product briefs, discovery notes, and architecture documents into a single high-signal context package for PRD drafting, design reviews, or implementation planning.

Quick Start

Ask the AI to distill your selected source documents into a bmad distillate for a downstream task such as PRD creation or architecture design.

Frequently Asked Questions about bmad-distillator

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

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

You can distill documents by asking the AI to analyze your source files and route them between single-pass or fan-out semantic compression. It outputs a high-signal context package, verifying completeness against headings and named entities to ensure no facts are lost.

What is the best way to prepare multiple architecture documents for PRD drafting?▼

The best way to prepare multiple architecture documents for PRD drafting is through lossless distillation. It applies thematic deduplication and completeness verification to convert your file set into a single, dense context package optimized for downstream language model workflows.

Can I validate that my compressed documents retain all original information?▼

Yes, you can validate information retention using optional round-trip reconstruction. The process checks completeness against headings and named entities, measures the compression ratio, and reconstructs source documents to confirm that facts and relationships are accurately preserved.

Does document distillation work with large sets of discovery notes and research reports?▼

Yes, document distillation works with large sets of discovery notes and research reports by applying fan-out compression and semantic splitting. It routes large outputs into self-contained topical sections, applying thematic deduplication to ensure token-efficient context packaging.

When should I use semantic splitting instead of single-file compression for knowledge extraction?▼

Use semantic splitting instead of single-file compression when processing large document sets that exceed optimal token limits. The routing mechanism analyzes your files and splits outputs into self-contained topical sections to maintain complete, lossless context for downstream LLM workflows.