Agent Powerups
Oh My Zsh for coding agents.
Agent Powerups is an Oh My Zsh-style collection of reusable skills, slash commands, MCP configs, hooks, AGENTS.md templates, and workflows for coding agents.
Today, this repo ships:
- reusable skills
- safe local CLI (
apx) with runnable local checks
- persistent Gemini relay for always-active secondary-agent delegation
- validation and requirement-check scripts
- verified local GitHub MCP check, smoke, and install flow
- command, hook, workflow, examples, and AGENTS.md templates
- 14 plugin bundles (7 beta, 7 experimental) with
apx plugins discovery, validation, and install flow
- user-intent profiles with
apx profiles for curated skill/plugin sets
Everything else stays conservative. No global mutation. No hidden install hooks. No fake marketplace claims.
What Is Here
| Path | Status | Notes |
|---|
skills/ | shipped | Reusable agent workflows such as systematic-debugging and writing-plans |
mcp/ | shipped | Local-first GitHub MCP config with check, smoke, and explicit install commands |
agents-md/ | shipped | Starter AGENTS.md templates |
commands/ | shipped | Review-first command prompts plus safe runnable checks |
hooks/ | shipped | Review-before-use hook recipes plus safe runnable checks |
workflows/ | shipped | Scenario guides |
plugins/ | shipped | 14 plugin bundles (7 beta, 7 experimental) with local-first discovery, validation, and install commands |
scripts/ | shipped | Validation and tool-check helpers for this repo |
examples/ | shipped | Minimal safe setup examples |
Quickstart
Using Source Checkout (Development)
- Clone and install deps:
git clone https://github.com/yeaight7/agent-powerups.git
cd agent-powerups
npm install
- Build CLI and install globally:
npm run build
npm link
- Check repo health:
apx doctor
apx doctor --full
- Browse catalog:
apx list
apx info markitdown-file-intake
apx commands run ship-check
apx hooks run no-secrets-preflight --all
apx mcp check github-local --target generic
apx mcp smoke github-local --json
apx mcp install github-local --target codex --dry-run
- Work with plugin bundles:
apx plugins list
apx plugins info dev-vitals
apx plugins validate --all
apx plugins install dev-vitals --target codex --dry-run
- Try a local advisor CLI and save an artifact:
apx ask-codex "Return OK only" --json
apx ask-claude "Return OK only" --json
apx ask-gemini "Return OK only" --json
- Start a persistent relay session (keeps context across turns):
apx relay init second-opinion
apx relay start second-opinion --provider gemini
apx relay ask second-opinion "Review this plan" --json
apx relay status second-opinion
apx relay stop second-opinion
- Browse profiles and apply one:
apx profiles list
apx profiles info safe-core
apx profiles apply safe-core --dry-run
- Check deps without installing:
apx check markitdown-file-intake
apx check ask-codex
apx check ask-claude
apx check ask-gemini
Preview supported dependency installers before asking for approval:
apx check defuddle --install-missing --dry-run
apx check markitdown-file-intake --install-missing --dry-run
- Dry-run safe install:
apx install markitdown-file-intake --target codex --dry-run
apx install ask-claude --target codex --dry-run
- Agent setup:
apx setup codex --dry-run
apx setup codex --mode minimal --yes # bootstrap only
apx setup codex --mode recommended --yes # main agent setup (recommended)
apx setup codex --mode full --yes # broad staging
Agent-managed setup (recommended)
Give your agent access to this repo and ask it to run:
apx list
apx profiles list
apx setup <codex|claude-code|gemini> --mode recommended --yes
Agent will inspect available skills/plugins, propose a plan, and apply it.
Manual setup
Dry-run first, then apply:
apx setup codex --dry-run
apx setup codex --mode recommended --yes
Agent setup docs:
- Keep repo validation in loop:
python scripts/validate-skills.py
python scripts/validate-catalog.py
python scripts/check-requirements.py
Catalog Overview
Current shipped skills:
systematic-debuggingno-fluffwriting-plansai-slop-cleanerbigquery-cost-auditdata-qualitydbt-incremental-strategy-auditdbt-preflightdbt-strategymetric-impact-analyzerrequesting-code-reviewreceiving-code-reviewpr-triagerepo-mapbug-huntsafe-refactorsql-business-logic-reviewdefuddlemarkitdown-file-intakeask-claudeask-geminiask-codexusing-powerups
Current shipped scripts:
