One-click install
npx skills add https://github.com/mlorentedev/dotfiles --skill crystallize-mlorentedev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crystallize
Source: https://github.com/mlorentedev/dotfiles/tree/main/harness/skills/crystallize
Command: npx skills add https://github.com/mlorentedev/dotfiles --skill crystallize-mlorentedev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Session observations and bugfix notes accumulate in agent memory (MEMORY.md) without ever becoming durable, searchable lessons, causing knowledge loss and memory bloat across sprints. ## Core Features & Use Cases - Gap Detection: Mines recent bugfix and decision observations and compares them against existing project lessons in docs/lessons/ and cross-project patterns in 00_meta/patterns/. - Lesson Authoring & Pattern Promotion: Writes new lessons with standard frontmatter, registers them in the lessons index, and promotes recurring lessons to cross-project pattern files. - Memory Maintenance: Trims MEMORY.md sections duplicated in CLAUDE.md, updates the Last Crystallized date, and stamps the vault via the dotf CLI. - Use Case: After finishing a major sprint, run the ritual to convert two weeks of unvaulted bugfix observations into indexed lessons and shrink an overgrown MEMORY.md. ## Quick Start Ask the agent to run the crystallize ritual to vault recent observations and clean up MEMORY.md.

Frequently Asked Questions about crystallize

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

FAQPage Schema
How do I turn AI session observations into permanent lessons?

Run the crystallize ritual, which mines recent bugfix and decision observations, detects gaps against existing lessons, and writes new frontmatter-tagged lesson files into docs/lessons/ with an updated index.

When should I run a knowledge crystallization ritual?

Run it when insights show unvaulted observations, when MEMORY.md exceeds 150 lines, when the last crystallization was over 14 days ago, or after completing a major sprint.

What is the difference between /insights and /crystallize?

The insights command is read-only and reports what needs attention, while crystallize is write mode and actually fixes the issues by creating lessons, promoting patterns, and trimming memory.

Where do project lessons versus cross-project patterns get stored?

Project lessons go to the repo's docs/lessons/ directory and are registered in its _index.md. Lessons appearing in more than one project are promoted to pattern files in the vault's 00_meta/patterns/ directory.

Does crystallize delete content from MEMORY.md?

It removes only sections already covered verbatim by CLAUDE.md, while keeping User Preferences, CI Pipeline, Bugs Found, Backlog Status, and the Last Crystallized date.