claudecode-bootstrap

ainb-toolkit — Portable AI-Agent Skills & Configs

One canonical source. Many AI tools. Write a skill once, install it into Claude Code, Codex, Copilot, Gemini, Hermes, nanoclaw, Amazon Q, Cursor, Cline, Roo, or Clawdhub.

This repository is the sole canonical home for the skills, the legacy bootstrap.js installer, and the catalog. It is consumed as an external source by ainb (the Rust unit manager) and is installable directly by any SKILL.md-aware agent harness.

Related repositories

Repo	What it holds
stevengonsalvez/ainb-toolkit (this repo)	Canonical skills (skills/), agents (agents/), workflows, utilities, the external-dependencies.yaml manifest, the bootstrap.js legacy installer, and the generated catalog.yaml.
stevengonsalvez/agents-in-a-box	The ainb TUI/CLI unit manager (Rust). Installs/browses skills from this repo as a pinned external source, generates the enriched catalog-index.json release asset, and ships the reflect plugin + reflect-kb retrieval CLI.

---

Install with ainb (recommended)

ainb (from the agents-in-a-box repo) treats this repo as an external skill provider and handles install / update / sync / drift across tool home dirs:

# Browse this repo's curated catalog
ainb skill browse "" --catalog ainb

# Add this repo as a source, then install any skill
ainb source add gh:stevengonsalvez/ainb-toolkit
ainb skill install gh:stevengonsalvez/ainb-toolkit@main/skills/<name> --targets claude --yes

# Verify + sync changes back to this repo
ainb skill check
ainb skill sync --to-repo

See the agents-in-a-box repo for ainb install (homebrew tap or cargo install).

---

Nix

The flattened skills/ and agents/ trees are exposed as Nix packages:

inputs.ainb-toolkit.url = "github:stevengonsalvez/ainb-toolkit";
# ...
skillsPkg = ainb-toolkit.packages.${system}.skills;   # $out/skills/<name>/...
agentsPkg = ainb-toolkit.packages.${system}.agents;   # $out/agents/<cat>/...

nix build github:stevengonsalvez/ainb-toolkit#skills

---

Quick start (legacy bootstrap.js)

The node installer still works and deploys the full tree to a tool home:

npm install

# Interactive (picks tool from menu)
node bootstrap.js

# Non-interactive (one tool)
node bootstrap.js --tool=claude-code-4.5
node bootstrap.js --tool=codex
node bootstrap.js --tool=copilot
node bootstrap.js --tool=gemini

# Verify everything landed (read-only)
node bootstrap.js --tool=claude-code-4.5 --verify

# Install external deps (git-cloned skills, npx-skills, claude plugins)
bash ~/.claude/setup-external.sh

Repeat for each target tool. Each tool gets its own home directory population (~/.claude/, ~/.codex/, …). Hermes is special — it reads from ~/.claude/skills/ via skills.external_dirs, so installing for Claude transitively covers Hermes.

---

Repository layout

This repo is flattened: the canonical source trees live directly at the repo root (there is no packages/ wrapper). Everything here gets distributed to tool home dirs on bootstrap (or installed individually by ainb).

skills/                 91 skills — agent-invokable SKILL.md bundles
agents/                 37 agents across 6 categories
├── design/             UI/UX designers
├── engineering/        backend, frontend, security, perf, code-review
├── meta/               agentmaker (create new agents)
├── orchestrators/      tech-lead, project-analyst, team-configurator
├── swarm/              worker/leader primitives for multi-agent work
└── universal/          backend-developer, frontend-developer, superstar-engineer
utilities/
├── config/             Shared tool config templates
├── hooks/              Event hooks (session-start, pre-commit, etc.)
├── output-styles/      Custom output formatters
├── reflections/        Session reflection templates
└── utils/              Shell utility libraries
workflows/
├── single-agent/       Guided plan → implement → validate flows
└── multi-agent/        Swarm/DAG orchestration commands
knowledge/
└── docs-solutions-template/

Per-tool config trees (claude-code-4.5/, codex/, copilot/, gemini/, amazonq/, cursor/, cline/, roo/, clawdhub/, …) and the shared general-rules/ also live at the repo root.

The reflect Claude Code plugin and the reflect-kb retrieval CLI are NOT in this repo — they live in the agents-in-a-box monorepo (plugins/reflect/ and reflect-kb/). bootstrap.js installs reflect-kb via uv tool install by cloning that monorepo; see the installReflectKb() function for details.

Skills at a glance (91 total, grouped by purpose)

Planning & Workflow (15)