distill

Extract domain entities, states, transitions, and boundaries into an Allium-style spec.

1|Updated May 22, 2013
One-click install
npx skills add https://github.com/scottopell/dotfiles --skill distill-scottopell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: distill
Source: https://github.com/scottopell/dotfiles/tree/main/home-dir-configs/claude/skills/allium/skills/distill
Command: npx skills add https://github.com/scottopell/dotfiles --skill distill-scottopell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Distill complex codebases into concise, domain-focused Allium specifications that capture intents, omissions, and boundaries.

Core Features & Use Cases

  • Extract domain entities, states, transitions, and rules from existing implementations.
  • Document scope, ownership, and boundaries to guide future refactors or new features.
  • Use to generate a formal Allium spec from monorepos, microservices, or libraries to align teams.

Quick Start

Identify a codebase you want to distill, then run the distill process to produce an Allium-style spec covering core domains and interactions.

Frequently Asked Questions about distill

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

FAQPage Schema
How do I extract domain specifications from an existing codebase?

To extract domain specifications from an existing codebase, you can distill the source code into a structured Allium spec. This process identifies core domain entities, states, transitions, and boundaries while separating domain concerns from implementation details.

What is the best way to reverse-engineer a monorepo into a formal spec?

The best way to reverse-engineer a monorepo into a formal spec is to use a code-to-spec distillation process. It transforms complex multi-service architectures into concise, domain-focused Allium specifications that capture intents and omissions.

Can I generate an Allium spec from microservices to align teams?

Yes, you can generate an Allium spec from microservices to align teams. The distillation process extracts domain rules, entities, and boundaries from multi-service architectures, producing a formal specification to guide future development.

Does reverse-engineering code into domain specs work for monorepos?

Reverse-engineering code into domain specs works effectively for monorepos. The distillation process separates domain concerns from implementation details across the codebase, outputting a structured spec detailing entities, states, and transitions.

When do I need to distill a codebase into a domain specification?

You need to distill a codebase into a domain specification when documenting scope, ownership, and boundaries to guide future refactors or new features. It helps align teams by capturing intents and omissions across complex architectures.

How do I document domain boundaries and states from an existing implementation?

To document domain boundaries and states from an existing implementation, apply a code-to-spec distillation process. It extracts entities, states, transitions, and rules from the source code into a structured Allium specification.