Get started

Quickstart

etyb installs as a single coordinated skill via npx skills, the universal installer for any agentskills.io-compliant agent. One command, 30 seconds, every agent on the machine.

terminal

$ npx skills add e-t-y-b/etyb-skills

The installer prompts you to choose which agents to wire up (defaults to the one you ran it from), what scope (project or global), and whether to symlink or copy. Symlink mode is the default — one source of truth in ~/.skills/, then linked into every agent's skills directory. Means one update propagates everywhere.

What gets installed

v4 collapsed the architecture into one skill — no per-tier choice, no peer skills competing at trigger time. Everything below ships in the box and is read from disk at runtime.

1

/etyb

coordinated skill

14

core team

engineering disciplines

9

protocols

always-on, no opt-in

6

verticals

regulated domains

13

vendor Stacks

currency-stamped

Recommended

`npx skills` — universal

One command. Works on every agent that follows the agentskills.io spec — Claude Code, OpenAI Codex, Google Antigravity, Cursor, Cline, Gemini CLI, OpenCode, Warp, Amp, Deep Agents, Dexto, Firebender, and Kimi Code CLI. Best for almost everyone.

install

$ npx skills add e-t-y-b/etyb-skills

Symlink vs copy

Symlink mode is the default — the skill is fetched once into ~/.skills/ and symlinked into each agent's skills directory. Switch to copy mode when you want each install isolated (useful if you bundle skills into a deployable container image).

Hook-enforced

Claude Code plugin

Native Claude Code plugin install. Same skill content as the npx route, plus shell hooks registered with Claude Code that fire outside the LLM. Gates like "no merge without green tests" and "no code without a failing test first" become physical, not model-trusted.

step 1 — add the marketplace

/plugin marketplace add e-t-y-b/etyb-skills

step 2 — install /etyb

/plugin install etyb@etyb-skills

Both routes drop the same files into Claude Code's skills directory. The plugin route additionally wires the hooks declared in .claude/settings.json. Install via /plugin once for the hook wiring; updates can come from either path.

Full control

Manual / git clone

Clone the repo and run install.sh. You get a local working copy you can fork, customize, or pin to a specific commit. Best for forks, air-gapped environments, or anyone who wants to read the source before installing.

clone + install

$ git clone https://github.com/e-t-y-b/etyb-skills.git
$ ./etyb-skills/scripts/install.sh

For OpenAI Codex, also run scripts/install-codex-runtime.sh after the main install — it adds 4 Codex lifecycle hooks and 4 custom agents. For Google Antigravity, install.sh alone is enough; the optional ADK integration lives at skills/etyb/adapters/antigravity/adk-integration.md.

Maintain

Update

etyb ships a release roughly weekly — currency-stamped Stack updates and protocol refinements. Re-running update is the way to keep vendor knowledge fresh.

update etyb only

$ npx skills update etyb

update every installed skill

$ npx skills update

Claude Code plugin: re-run /plugin install etyb@etyb-skills — the marketplace tracks releases and the hooks get re-wired automatically. Manual clone: cd etyb-skills && ./scripts/update.sh (or just git pull && ./scripts/install.sh — same effect, with the v3 → v4 migration check and a changelog preview).

Uninstall

v4 ships as one folder. Remove it via the CLI or by deleting the symlink — the source in ~/.skills/ gets cleaned up automatically if no other agent references it.

npx

$ npx skills remove etyb

manual delete

$ rm -rf .claude/skills/etyb

Migrate from v3

install.sh detects v3 sibling skills (research-analyst, tdd-protocol, etc.) and stale hook paths in .claude/settings.json, then offers to back them up. Plans and local settings are never touched.

re-run install — it handles v3 → v4

$ ./scripts/install.sh

v3.x bundles (full, process-protocols, core-team, verticals) and the --bundle / --skills flags are gone — v4 ships everything in one skill, so per-tier choice is unnecessary.

Reference

`npx skills` CLI

Every command the universal installer exposes. Run npx skills --help for the full reference straight from the binary.

npx skills add e-t-y-b/etyb-skills install

Install etyb. Prompts for which agents to target and which install method (symlink or copy).

npx skills update etyb update

Update etyb to the latest version. Symlink installs propagate to every agent on the machine.

npx skills update

Update every installed skill, not just etyb.

npx skills list

List every skill currently installed, with version and install location.

npx skills remove etyb uninstall

Uninstall etyb. Removes the symlink and the source directory if no other agent references it.

npx skills --help

Full CLI reference straight from the installer.

Supported agents

The universal installer auto-detects 14 agents at install time. All of them are agentskills.io-compliant; any future agent that adopts the spec works without a code change here.

Claude Code
OpenAI Codex
Google Antigravity
Cursor
Cline
Gemini CLI
OpenCode
Warp
Amp
GitHub Copilot
Deep Agents
Dexto
Firebender
Kimi Code CLI

Flags & options

Every flag install.sh accepts — used by the manual route directly and by npx skills under the hood. Skip this section unless you need to override default behavior.

--target <path>

Override the auto-detected target directory. install.sh tries .claude/skills, .agents/skills, .agent/skills, then skills/ in order — pass --target to skip the search.

./scripts/install.sh --target .claude/skills

--dry-run

Print what install.sh would do (target dir, conflict resolution, v3 → v4 migrations) without copying any files or rewriting any settings.

./scripts/install.sh --dry-run

--force

Replace any existing /etyb (and v3 sibling skills) without prompting. Previous installs are kept as *.bak.<timestamp> siblings — never silently destroyed.

./scripts/install.sh --force

--on-conflict <mode>

Pick one of prompt | replace | keep | skip. Default is prompt. keep preserves the old install as etyb.bak.<ts> and writes fresh.

./scripts/install.sh --on-conflict keep

Troubleshooting

The installer can't find my agent's skills directory.

Pass --target with an explicit path. install.sh tries .claude/skills, .agents/skills, .agent/skills, then skills/.

I already have a v3 install — will this overwrite it?

No. install.sh detects v3 sibling skills and offers to back them up as *.bak.<timestamp>. Use --dry-run to preview the migration without writing anything.

I want to pin a specific version.

Use the manual route and pin a commit: git checkout <sha> before running ./scripts/install.sh. Or fork the repo and point npx skills add at your fork.

Updates aren't propagating to my other agents.

You're probably on copy install, not symlink. Re-run npx skills add e-t-y-b/etyb-skills and pick symlink at the prompt. One source, all agents synced.

Still stuck? Open an issue on GitHub or check the FAQ.

Install etyb in
one command.