kss · explainers

kss, in different lenses.

Single-file interactive artifacts that explain what kss is and how its parts fit together. Each one is a different lens on the same framework. Open in any browser — no build step, no dependencies.

For the command reference and lifecycle diagram, see plugins/kss/README.md.

00

Overview & reference

Start here. The comprehensive guide — what kss solves, the detect-and-offer principle, the self-improvement loop, all 13 skills by layer, the decision flow, and the .kss/ conventions. One page, no slides.

comprehensive guide · what + why + 13 skills + conventions
01

kss in 6 slides

The pitch deck. Problem → core idea → 13 skills, by layer → self-improvement loop → install. Scroll-snap slides, ←/→ navigation. 30 seconds to skim, 3 minutes to internalize.

slide deck · 6 viewports · keyboard navigation
02

The self-improvement loop

Interactive concept explainer for skill-autopsy — the one mechanic in kss that isn't part of the workflow lifecycle. Click slots on the timeline to set the report count; flip the ~/.kss-source toggle to see how the outcome differs for forkers vs. plain installs.

concept explainer · interactive timeline · live readouts
03

How the 13 skills interact

Data ownership graph. The README mermaid shows lifecycle ordering; this shows the other lens. Click any skill to see what it writes, what it reads, downstream consumers, upstream feeders, and which failure mode it prevents.

surface tour · 13 skills · click-to-deepen + chip navigation
04

The .kss/ file system

Surface tour of every file under .kss/ — who writes it, who reads it, append-only vs. overwrite vs. pointer behavior, and the three design surprises that aren't obvious on first read. Tabs across root, codebase, topics, and spikes.

surface tour · 4 tabs · status pills + field tables