crystallize

Extract settled design decisions and save them as structured markdown crystal files.

1|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/n0rvyn/indie-toolkit --skill crystallize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crystallize
Source: https://github.com/n0rvyn/indie-toolkit/tree/main/dev-workflow/skills/crystallize
Command: npx skills add https://github.com/n0rvyn/indie-toolkit --skill crystallize

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill extracts settled decisions from the current conversation and creates a persistent, machine-readable decision crystal that downstream plan-writing and verification steps can consume, preventing loss of context across sessions.

Core Features & Use Cases

  • Decision extraction: Scans conversation context for high- and medium-signal decision indicators (brainstorm outputs, design-decision tables, explicit user decisions, revert events) and marks inferred items separately.
  • Structured crystal files: Produces standardized markdown crystals in docs/11-crystals/ with sections for Initial Idea, Discussion Points, Rejected Alternatives, Decisions (D-xxx), AI-supplemented items, Constraints, Scope Boundaries, and Source Context for traceability.
  • Use Cases: Use after brainstorm or design-decision sessions before /write-plan, during handoff to preserve decisions for the next session, or whenever a user requests "lock this" or "crystallize".

Quick Start

Run crystallize to extract and save the settled decisions from the current conversation as a decision crystal file.

Frequently Asked Questions about crystallize

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

FAQPage Schema
How do I preserve design decisions after a brainstorming session?

To preserve design decisions after brainstorming, extract settled decisions from your conversation and save them as structured markdown files. This captures constraints, rejected alternatives, and final choices to prevent context loss across sessions.

What is a decision crystal file for tracking design choices?

A decision crystal file is a standardized markdown document used for tracking design choices. It structures Initial Ideas, Discussion Points, Rejected Alternatives, and Decisions with Source Context to ensure traceability and machine-readable knowledge persistence.

How do I document rejected alternatives and constraints for handoff?

Document rejected alternatives and constraints for handoff by scanning the conversation context for decision indicators and persisting them as markdown files. This ensures the next session can verify decisions against the original scope boundaries.

Can I save settled decisions directly to my project documentation directory?

Yes, you can save settled decisions directly to your project documentation directory. The process requires write permission to save dated topic crystal markdown files into the docs folder for downstream plan writing.

What is the best way to lock in scope boundaries before writing a plan?

The best way to lock in scope boundaries before writing a plan is to extract explicit user decisions and revert events from the current context into a persistent crystal file. This allows the plan-writing step to consume verified constraints.

Does the decision tracking process capture inferred items separately from explicit decisions?

Yes, the decision tracking process captures inferred items separately from explicit decisions. It scans for high- and medium-signal indicators, marking AI-supplemented items distinctly from direct user decisions within the structured markdown output.