SKILL.Md

SKILL.md — The Self-Improving Claude Code

Look at your current AI setup. You write a brilliant prompt. It works perfectly on Monday. But by Friday? A framework updates. A new pattern emerges. Your prompt is dead. It is rotting on your hard drive! *This is a tragedy of static configuration.*

We are going to fix this today. Not by writing more prompts. By building a system that *learns*.

This repository contains drop-in [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) components that make your setup self-improving. I will demonstrate the flagship command: `/learn`.

Watch what happens when we unleash this system on the real world:

/learn https://svelte.dev/docs/kit          # We feed it documentation!
/learn ~/docs/architecture.md               # We feed it local designs!
/learn ~/.claude/plugins/marketplaces/      # We absorb other skills!
/learn ~/projects/my-api                    # We extract patterns from living code!

Read the SvelteKit 5 migration guide? Your `sveltekit-patterns` skill now knows about runes. Discovered a new Express middleware pattern? Your `api-middleware` skill just got smarter. It adapts!

---

The Architecture: Three Fundamental Layers

If you put everything in one file, the system collapses into chaos. We must have a profound separation of concerns. Three layers. Each doing exactly one thing. It is beautiful!

flowchart TD
    Source["/learn <source>"] --> Command
    
    subgraph Architecture ["Three layers, each doing one thing well"]
        Command["COMMAND (26 lines)
Thin trigger. Delegates everything to the specialist."]
        Agent["AGENT (skill-learning-specialist)
The orchestrator. Handles URLs, directories, repos.
Manages the approval loop. Doesn't contain methodology."]
        Skill["SKILL (skill-learning)
The brain. 7-phase workflow. Novelty detection.
Matching algorithm. CLEAR validation. All the methodology.