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.