singularity-claude

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: