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 — Adversarial staff-engineer review upgrading agent plans using live codebase inspection and SOTA research.
debugging-workflow — Systematic root-cause isolation, minimal reproduction, and regression testing.
emergency-procedures — Recovery protocols for broken agent loops, git tangle, and context drift.

Writing & UI Craft

fuck-slop — Multi-genre de-slop pass eliminating statistical AI writing fingerprints.
interface-kit — Authoritative implementation guide for UI craft, spring animations, and WCAG AA accessibility.

Spec-Driven Development (SDD) Suite

grill — Calibrated plan interrogation before speccing.
spec — Sole mutator of SPEC.md managing goals, invariants, tasks, and bugs.
caveman — Token-compression dialect (~75% reduction) for dense invariant specification.
review — Adversarial pre-implementation spec refutation and gatekeeper.
build — Single-threaded plan-to-execute loop with automated test oracles.
check — Read-only drift detector verifying code against active invariants.
backprop — Bug-to-spec feedback loop binding regression tests.
deepen — Module design pass pulling complexity down and shrinking interfaces.

Architecture & Security

api-design — REST membranes, contract-first schemas, and boundary clamping.
database-design — SQLite WAL persistence, repository abstraction, and keyset pagination.
app-security — Four-Pillar upload defense, outbound SSRF guards, and secret masking.
git-workflow — Atomic commit grouping, selective staging, and conventional commits.

Meta & Infrastructure

deliver-file — Push files and directories to the user's workstation over Tailscale SSH via t3-deliver.
skill-architect — Standardized authoring, auditing, and maintenance of global agent skills.

Usage

./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

Create skills/<skill-name>/SKILL.md following the sample-skill blueprint.
Run ./sync-skills.sh.
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).

4.1 KiB Raw Blame History