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-debugging
no-fluff
writing-plans
ai-slop-cleaner
bigquery-cost-audit
data-quality
dbt-incremental-strategy-audit
dbt-preflight
dbt-strategy
metric-impact-analyzer
requesting-code-review
receiving-code-review
pr-triage
repo-map
bug-hunt
safe-refactor
sql-business-logic-review
defuddle
markitdown-file-intake
ask-claude
ask-gemini
ask-codex
using-powerups

Current shipped scripts:

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-debugging
no-fluff
writing-plans
ai-slop-cleaner
bigquery-cost-audit
data-quality
dbt-incremental-strategy-audit
dbt-preflight
dbt-strategy
metric-impact-analyzer
requesting-code-review
receiving-code-review
pr-triage
repo-map
bug-hunt
safe-refactor
sql-business-logic-review
defuddle
markitdown-file-intake
ask-claude
ask-gemini
ask-codex
using-powerups

Current shipped scripts:

Help us improve

Find plugins for your project

Help us improve

spec-driven-development

Popularity

What's Inside

Help us improve

Health & Quality

Confidence

README

Agent Powerups

What Is Here

Quickstart

Using Source Checkout (Development)

Agent-managed setup (recommended)

Manual setup

Catalog Overview

Similar Plugins

ui-design

llm-council-plugin

drawio-diagramming

More by yeaight7

data-engineering

codebase-intelligence

agentic-systems

debugging-diagnostics

dev-vitals

Agent Powerups

What Is Here

Quickstart

Using Source Checkout (Development)

Agent-managed setup (recommended)

Manual setup

Catalog Overview