README.md

# global-skills

Personal skill repository shared by every coding agent on this host
(Antigravity/agy, Codex, OpenCode, Claude Code). Kept separate from JEV,
which remains its own project with its own skills.

## Sources

Agents see skills from two sources:

| Source | Owner | Path |
|---|---|---|
| This repo | here | `~/Projects/work/global-skills/skills/` |
| JEV skills | JEV project | `~/Projects/work/JEV/.agents/skills/` |

## Targets

`sync-skills.sh` maintains symlinks into each agent's skills directory:

- `~/.agents/skills` (OpenCode)
- `~/.codex/skills` (Codex)
- `~/.claude/skills` (Claude Code)

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
./sync-skills.sh          # after adding/updating/removing a skill
```

Idempotent: re-links only what changed, never touches unrelated entries
(omarchy system skills etc.), warns on name collisions between the two
sources (this repo wins).

## Adding a skill

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.

## t3-deliver

`bin/t3-deliver` is symlinked to `~/.local/bin/t3-deliver`. It prints a
ready-to-paste `scp` command (Tailscale SSH) so the user can pull any file
from this host to their Windows machine. The `deliver-file` skill teaches
every agent to use it.

## T3 integration

Open this folder as a project in T3 Code to get a top-bar Action running
`sync-skills.sh` (Actions are project-scoped commands).
Initial commit: deliver-file skill, t3-deliver, sync script 2026-10-13 16:02:42 +08:00			`# global-skills`

			`Personal skill repository shared by every coding agent on this host`
			`(Antigravity/agy, Codex, OpenCode, Claude Code). Kept separate from JEV,`
			`which remains its own project with its own skills.`

			`## Sources`

			`Agents see skills from two sources:`

			`\| Source \| Owner \| Path \|`
			`\|---\|---\|---\|`
			\| This repo \| here \| `~/Projects/work/global-skills/skills/` \|
			\| JEV skills \| JEV project \| `~/Projects/work/JEV/.agents/skills/` \|

			`## Targets`

			`sync-skills.sh` maintains symlinks into each agent's skills directory:

			- `~/.agents/skills` (OpenCode)
			- `~/.codex/skills` (Codex)
			- `~/.claude/skills` (Claude Code)

			Antigravity reads both sources directly via `~/.gemini/config/skills.json`.

docs: document imported skills in README catalog 2026-10-13 16:48:33 +08:00			`## 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.

Initial commit: deliver-file skill, t3-deliver, sync script 2026-10-13 16:02:42 +08:00			`## Usage`

			```sh
			`./sync-skills.sh # after adding/updating/removing a skill`
			```

			`Idempotent: re-links only what changed, never touches unrelated entries`
			`(omarchy system skills etc.), warns on name collisions between the two`
			`sources (this repo wins).`

			`## Adding a skill`

docs: document imported skills in README catalog 2026-10-13 16:48:33 +08:00			1. Create `skills/<skill-name>/SKILL.md` following the [sample-skill blueprint](skills/skill-architect/references/sample-skill.md).
Initial commit: deliver-file skill, t3-deliver, sync script 2026-10-13 16:02:42 +08:00			2. Run `./sync-skills.sh`.
			`3. Commit.`

			`## t3-deliver`

			`bin/t3-deliver` is symlinked to `~/.local/bin/t3-deliver`. It prints a
			ready-to-paste `scp` command (Tailscale SSH) so the user can pull any file
			from this host to their Windows machine. The `deliver-file` skill teaches
			`every agent to use it.`

			`## T3 integration`

			`Open this folder as a project in T3 Code to get a top-bar Action running`
			`sync-skills.sh` (Actions are project-scoped commands).