distill

Generate structured insight documents with YAML frontmatter under docs/insights/.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/mbriggsy/ai-learning-journey --skill distill-mbriggsy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: distill
Source: https://github.com/mbriggsy/ai-learning-journey/tree/main/projects/skills/distill-and-brief/distill
Command: npx skills add https://github.com/mbriggsy/ai-learning-journey --skill distill-mbriggsy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Preserve hard-won technical insights so future sessions don't rediscover them.

Core Features & Use Cases

  • Generates a structured insight doc under docs/insights/ with a YAML frontmatter and five required sections: Problem, Root Cause, Fix, Key Insight, Also Applies To.
  • Auto-numbers the next insight file by scanning docs/insights/ and incrementing.
  • Enforces a standard template and provides a quick-start flow; supports gating/hook mechanisms to ensure capture happens when appropriate.

Quick Start

Trigger the workflow by saying distill or capture this to create a new insight doc under docs/insights with the next sequential number.

Frequently Asked Questions about distill

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

FAQPage Schema
How do I preserve technical debugging insights so future sessions don't rediscover them?▼

To preserve technical debugging insights, you can generate structured insight documents with strict frontmatter and enforced sections like Problem, Root Cause, and Fix. This creates a searchable library preventing knowledge loss between sessions.

What is the best way to document root cause analysis findings for future reference?▼

The best way to document root cause analysis is using a standardized template with required sections: Problem, Root Cause, Fix, Key Insight, and Also Applies To. This ensures consistent, searchable artifacts for cross-project learnings.

How do I automatically number knowledge management documents in my repository?▼

You can automatically number knowledge management documents by storing them in a dedicated insights directory. The system scans existing files and auto-increments the next sequential number for new insight documents.

Do I need a specific directory structure to capture post-mortem learnings?▼

Yes, capturing post-mortem learnings requires an insights directory at docs/insights/. This dedicated path enables auto-numbering and ensures your structured insight documents are stored consistently.

Can I enforce a standard template for cross-project technical insights?▼

Yes, you can enforce a standard template for cross-project technical insights. The system mandates a strict frontmatter template and five specific sections to generate consistent, searchable artifacts across your projects.

What are the limitations of relying on manual notes for knowledge management?▼

Manual notes lack structured fields like Root Cause and Also Applies To, leading to inconsistent documentation. Enforcing a standardized template with required sections prevents knowledge loss and ensures searchable, cross-project artifacts.