docs: document imported skills in README catalog

README.md

@@ -23,6 +23,39 @@ Agents see skills from two sources:
 
 Antigravity reads both sources directly via `~/.gemini/config/skills.json`.
 
+## Skill Catalog
+
+All skills adhere to the 5-phase Skill Architect anatomy (`Phase 0: Setup` through `Phase 4: Output Execution & Verification`) with System One balance invariants.
+
+### Planning & Review
+- [`junior-to-senior`](skills/junior-to-senior/SKILL.md) — Adversarial staff-engineer review upgrading agent plans using live codebase inspection and SOTA research.
+- [`debugging-workflow`](skills/debugging-workflow/SKILL.md) — Systematic root-cause isolation, minimal reproduction, and regression testing.
+- [`emergency-procedures`](skills/emergency-procedures/SKILL.md) — Recovery protocols for broken agent loops, git tangle, and context drift.
+
+### Writing & UI Craft
+- [`fuck-slop`](skills/fuck-slop/SKILL.md) — Multi-genre de-slop pass eliminating statistical AI writing fingerprints.
+- [`interface-kit`](skills/interface-kit/SKILL.md) — Authoritative implementation guide for UI craft, spring animations, and WCAG AA accessibility.
+
+### Spec-Driven Development (SDD) Suite
+- [`grill`](skills/grill/SKILL.md) — Calibrated plan interrogation before speccing.
+- [`spec`](skills/spec/SKILL.md) — Sole mutator of `SPEC.md` managing goals, invariants, tasks, and bugs.
+- [`caveman`](skills/caveman/SKILL.md) — Token-compression dialect (~75% reduction) for dense invariant specification.
+- [`review`](skills/review/SKILL.md) — Adversarial pre-implementation spec refutation and gatekeeper.
+- [`build`](skills/build/SKILL.md) — Single-threaded plan-to-execute loop with automated test oracles.
+- [`check`](skills/check/SKILL.md) — Read-only drift detector verifying code against active invariants.
+- [`backprop`](skills/backprop/SKILL.md) — Bug-to-spec feedback loop binding regression tests.
+- [`deepen`](skills/deepen/SKILL.md) — Module design pass pulling complexity down and shrinking interfaces.
+
+### Architecture & Security
+- [`api-design`](skills/api-design/SKILL.md) — REST membranes, contract-first schemas, and boundary clamping.
+- [`database-design`](skills/database-design/SKILL.md) — SQLite WAL persistence, repository abstraction, and keyset pagination.
+- [`app-security`](skills/app-security/SKILL.md) — Four-Pillar upload defense, outbound SSRF guards, and secret masking.
+- [`git-workflow`](skills/git-workflow/SKILL.md) — Atomic commit grouping, selective staging, and conventional commits.
+
+### Meta & Infrastructure
+- [`deliver-file`](skills/deliver-file/SKILL.md) — Push files and directories to the user's workstation over Tailscale SSH via `t3-deliver`.
+- [`skill-architect`](skills/skill-architect/SKILL.md) — Standardized authoring, auditing, and maintenance of global agent skills.
+
 ## Usage
 
 ```sh
@@ -35,7 +68,7 @@ sources (this repo wins).
 
 ## Adding a skill
 
-1. Create `skills/<skill-name>/SKILL.md` with frontmatter `name` + `description`.
+1. Create `skills/<skill-name>/SKILL.md` following the [sample-skill blueprint](skills/skill-architect/references/sample-skill.md).
 2. Run `./sync-skills.sh`.
 3. Commit.