distill

Distill codebases into Allium specifications capturing domain-level behaviours.

Updated Apr 27, 2026
One-click install
npx skills add https://github.com/ravenoak/oh-my-stigmergy --skill distill-ravenoak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: distill
Source: https://github.com/ravenoak/oh-my-stigmergy/tree/main/.agents/skills/distill
Command: npx skills add https://github.com/ravenoak/oh-my-stigmergy --skill distill-ravenoak

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Distill codebases into Allium specifications that capture domain-level behaviours while omitting implementation details. This skill helps teams convert implementation insights into a stable, domain-focused specification that can guide future design and validation efforts.

Core Features & Use Cases

  • Identify domain entities, states, and transitions from codebases
  • Derive end-to-end Allium specifications with rules, boundaries, and external interfaces
  • Provide worked examples and library-spec signals to promote reuse across projects

Quick Start

Provide a codebase path and request an Allium distillation to generate a complete spec.

Frequently Asked Questions about distill

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

FAQPage Schema
How do I reverse-engineer a codebase into domain-level specifications?

To reverse-engineer a codebase into domain-level specifications, you distill source code to identify domain entities, states, transitions, and external boundaries, producing a structured Allium spec that omits implementation details like ORM and SQL constructs.

What is an Allium specification and what does it include?

An Allium specification is a structured artefact that captures domain-level behaviours while omitting implementation details. It includes identified domain entities, rules, library spec signals, and external boundaries derived from your codebase.

Can I derive specifications for a multi-service mono-repo?

Yes, you can derive specifications for a multi-service mono-repo. The distillation process applies to mono-repos or multi-service architectures by identifying consistent domain entities, states, and transitions across the codebase.

How do I generate Allium specs from an existing codebase?

To generate Allium specs from an existing codebase, provide the codebase path and request a distillation. The process extracts domain entities, rules, and boundaries to produce a complete, structured Allium artefact for design validation.

What implementation details are omitted when distilling code into specifications?

When distilling code into specifications, ORM, SQL, and language-specific constructs are omitted. The resulting specification focuses exclusively on stable domain-level behaviours, rules, and external boundaries rather than technical implementation.