Crystallizing

Crystallize a Validated Skill

Lock a battle-tested skill version as production-grade. Crystallized skills are immutable — further changes require a new version.

When to Use

• Skill average score >= 90 with 5+ executions
• Skill has handled at least one edge case
• User confirms the skill is ready

Workflow

Step 1: Validate Readiness

Read score file and config:

"${CLAUDE_PLUGIN_ROOT}/scripts/score-manager.sh" trend 

Check requirements:

• [ ] Average score >= crystallizationThreshold (default: 90)
• [ ] Execution count >= crystallizationMinExecutions (default: 5)
• [ ] At least one edge case recorded in score history
• [ ] Maturity is hardened (not draft or tested)

If not ready, explain what's missing: "This skill needs before crystallization."

Step 2: Confirm with User

Show the skill's full score summary and ask: "Ready to crystallize v? This locks the current version as immutable."

Step 3: Create Git Tag

If ~/.claude/skills/ is a git repository:

cd ~/.claude/skills
git add /
git commit -m "singularity: crystallize  v"
git tag "singularity//v"

If not a git repo, create a backup copy:

mkdir -p ~/.claude/singularity/crystallized//
cp -r ~/.claude/skills// ~/.claude/singularity/crystallized//v/

Step 4: Update Records

Update score file:

• Set maturity to "crystallized" for the current version

Update registry:

• Set maturity to "crystallized"

Step 5: Log Telemetry

"${CLAUDE_PLUGIN_ROOT}/scripts/telemetry-writer.sh" log  \
  --trigger "crystallization" \
  --summary "Crystallized v (avg: /100,  runs)"

Report

Crystallized:  v
  Average score: /100 over  executions
  Edge cases handled: 
  Git tag: singularity//v
  Status: LOCKED — further changes require a new version

Rollback

To recover a crystallized version later:

git checkout singularity//v -- /

Or restore from backup:

cp -r ~/.claude/singularity/crystallized//v/ ~/.claude/skills//

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Shmayro
• Source: Shmayro/singularity-claude
• License: MIT

Install and usage instructions live in the source repository linked above.