singularity-claude
Skills that evolve themselves.
A self-evolving skill engine for Claude Code — create, score, repair, and crystallize skills through autonomous recursive improvement loops.
The Problem
Claude Code skills are static. You write them once, and they stay exactly as they are — even when they fail, produce subpar output, or encounter new edge cases. There's no feedback loop, no way to know which skills are working well, and no mechanism to improve them over time.
You end up with a growing pile of skills where some work great, some are mediocre, and some are silently broken. The only way to fix them is manual review.
The Solution
singularity-claude adds a recursive evolution loop to your skills:
graph TD
Goal["🎯 Goal:<br/>Set up API proxy endpoints"]
Goal --> HasSkill{Skill exists?}
HasSkill -->|No| Gap["🔍 Gap detected:<br/>recurring pattern"]
Gap --> Create["⚙️ /singularity-create\nGather requirements\nGenerate SKILL.md\nRegister + init scoring"]
Create --> Execute
HasSkill -->|Yes| Execute["⚡ Execute skill"]
Execute --> Score["📊 /singularity-score\nDispatch assessor agent\nRate 5 dimensions · 0-100"]
Score --> Maturity["🔄 Auto-update maturity\ndraft → tested → hardened"]
Maturity --> Low{Avg < 50\n2+ runs?}
Low -->|Yes| Repair["🔧 /singularity-repair\nAnalyze telemetry\nRewrite weak dimensions\nBump version · re-test"]
Repair --> Execute
Low -->|No| High{Avg ≥ 90 · 5+ runs\nhardened · edge cases?}
High -->|Yes| Crystal["💎 /singularity-crystallize\nGit tag + lock version"]
Crystal --> Done["✅ Production-grade skill\nImmutable · rollback-safe"]
High -->|No| Loop["🔁 Keep using + scoring"]
Loop --> Execute
style Goal fill:#1d3557,color:#fff,stroke:#0d1b2a
style Gap fill:#e9ecef,color:#000,stroke:#adb5bd
style Create fill:#457b9d,color:#fff,stroke:#1d3557
style Execute fill:#2a9d8f,color:#fff,stroke:#1a7a6e
style Score fill:#e76f51,color:#fff,stroke:#c1440e
style Maturity fill:#264653,color:#fff,stroke:#1d3540
style Low fill:#fff3cd,color:#000,stroke:#ffc107
style High fill:#d4edda,color:#000,stroke:#28a745
style Repair fill:#f4a261,color:#000,stroke:#e76f51
style Crystal fill:#2d6a4f,color:#fff,stroke:#1b4332
style Done fill:#1b4332,color:#fff,stroke:#0d2818
style Loop fill:#a8dadc,color:#000,stroke:#457b9d
Tip: Click the expand button (↔) on the diagram to see the full interactive flow.
Skills are scored after every execution. Low scores trigger automatic repair. High scores lead to crystallization — a locked, battle-tested version you can trust. Every step is logged for full auditability.
No external dependencies. No SmythOS, no OpenTelemetry collector, no Docker. Pure Claude Code.
What's Inside
Skills (7)
| Skill | Command | Purpose |
|---|---|---|
| using-singularity | (auto-loaded) | Bootstrap context + capability gap detection |
| creating-skills | /singularity-create | Build new skills through a structured workflow |
| scoring | /singularity-score | Rate execution on a 5-dimension rubric (0-100) |
| repairing | /singularity-repair | Auto-fix failing skills by analyzing score history |
| crystallizing | /singularity-crystallize | Lock validated versions via git tags |
| reviewing | /singularity-review | Health check with trend analysis |
| dashboard | /singularity-dashboard | Overview of all managed skills |
Agents (2)
| Agent | Model | Purpose |
|---|---|---|
| skill-assessor | Haiku | Fast, cheap automated scoring against the rubric |
| gap-detector | Haiku | Analyzes failed tasks to find missing skill capabilities |
Scripts (2)
| Script | Purpose |
|---|---|
score-manager.sh | CLI for reading/writing score JSON files (atomic writes, jq/node fallback) |
telemetry-writer.sh | CLI for structured execution logging with replay support |
Installation
From the official Claude Code plugin registry
Requires Claude Code CLI
Inside a Claude Code session, run: