Skills

Use this repo as your user skills directory:

./install.sh

git submodule update --init populates vendor/vercel-agent-skills, which the skills/react-best-practices symlink points into. The submodule is declared shallow = true in .gitmodules, so this fetches only the latest commit.

For Amp, ~/.config/amp/settings.json can also point directly at this directory with amp.skills.path. Keep ~/.agents/skills linked too; Amp path-scoped guidance @-mentions that path.

Global Instructions

install.sh symlinks:

• Amp: global/AGENTS.md, checks/, and ~/.agents/skills
• Claude Code: global/CLAUDE.md and each skill under ~/.claude/skills/
• Codex: global/CODEX.md and each skill under ~/.codex/skills/

Check an existing install without changing links:

./install.sh --check

Edit global/parts/ — the pre-commit hook rebuilds automatically.

global/claude.settings.json is a reference settings file. Merge it manually instead of symlinking it over an existing ~/.claude/settings.json.

Path-scoped guidance uses Claude Code paths and Amp globs frontmatter in skill files. For Amp, add or remove @ mentions in global/parts/20-path-scoped.amp.md.

Preferred Tools

The global instructions assume these CLI tools are available:

brew install ast-grep fd jq ripgrep sd yq

Project-scoped Skills

Skills under project-skills/ are not installed globally — install.sh ignores them. They carry conventions specific to one codebase, so install them only into the repos where they apply, with skills.sh (npx skills). Run inside the target repo and pick the project scope when prompted:

npx skills add arcboxlabs/agent-skills/project-skills/linear

This installs into the repo's own .claude/skills/ (and any other detected agent's project dir), so Claude Code loads it only within that repo. The repo is private, so npx skills needs GitHub auth. Add --copy to vendor the files instead of symlinking; --global installs into ~/.claude/skills for every project (the opposite of what you usually want here).

• linear: ArcBox Linear workflow — issue lifecycle, comment-driven sync, status, triage

Available Skills

• better-skill-creator: write better skills than the default
• browser-testing: browser automation with Playwright MCP
• rust-coding: write high-quality Rust code
• slides-creator: create new slide decks and .pptx presentations
• waku-idiomatic: opinionated Waku patterns and structure

Vendored

Symlinked from vendor/vercel-agent-skills (vercel-labs/agent-skills):

• react-best-practices: React and Next.js performance patterns from Vercel Engineering

Symlinked from vendor/karpathy-skills (multica-ai/andrej-karpathy-skills):

• karpathy-guidelines: behavioral guidelines to reduce common LLM coding mistakes