From 98bb35e6fb4e001f81bd9c924e097c99c028a47c Mon Sep 17 00:00:00 2001 From: vasily Date: Tue, 13 Oct 2026 16:48:33 +0800 Subject: [PATCH] docs: document imported skills in README catalog --- README.md | 35 ++++++++++++++++++++++++++++++++++- 1 file changed, 34 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 80a9e6c..bfe900f 100644 --- a/README.md +++ b/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.md` with frontmatter `name` + `description`. +1. Create `skills//SKILL.md` following the [sample-skill blueprint](skills/skill-architect/references/sample-skill.md). 2. Run `./sync-skills.sh`. 3. Commit.