Distill Skill
Distill PDF, URL, or text into Q&A pairs and store in memory.
Happy Path
# Distill a PDF into memory
./run.sh --file paper.pdf --scope research
# With domain focus (recommended for better relevance)
./run.sh --file paper.pdf --scope research --context "ML researcher"
# Preview before storing
./run.sh --file paper.pdf --dry-run
# From URL
./run.sh --url https://example.com/article --scope web
Parameters
| Flag | Description |
|---|---|
--file |
PDF, markdown, or text file |
--url |
URL to fetch and distill |
--scope |
Memory scope (default: research) |
--context |
Domain focus, e.g. "security expert" |
--dry-run |
Preview without storing |
--json |
JSON output |
--sections-only |
Extract sections only (no Q&A) |
What It Does
- Extract content from PDF/URL/text
- Split into logical sections
- Generate Q&A pairs via LLM
- Validate answers are grounded in source
- Store to memory via
memory-agent learn
Examples
# Research paper
./run.sh --file arxiv_paper.pdf --scope research --context "ML researcher"
# Technical documentation
./run.sh --file api_docs.md --scope project --context "backend developer"
# Just extract sections (no Q&A)
./run.sh --file paper.pdf --sections-only --json
Environment Variables (Optional Tuning)
| Variable | Default | Description |
|---|---|---|
DISTILL_PDF_MODE |
fast | PDF mode: fast, accurate, auto |
DISTILL_CONCURRENCY |
6 | Parallel LLM requests |
DISTILL_GROUNDING_THRESH |
0.6 | Grounding similarity threshold |
DISTILL_NO_GROUNDING |
- | Set to 1 to skip validation |