Plugin

debugging-diagnostics

Name: debugging-diagnostics
Author: yeaight7

Systematically debug, isolate, and fix bugs across code, tests, and production logs using structured diagnosis, flaky test analysis, git bisect, and blameless post-mortems.

What's Inside

Slash Commands4

Create Reproduction

/create-repro

Isolate a bug report into a minimal, standalone reproduction script or test case.

debug

/debug

Use when a bug needs systematic diagnosis before a fix is attempted.

Diagnose Failure

/diagnose-failure

Systematically analyze a reported error, stack trace, or failure state to identify the root cause and propose a fix.

Trace Regression

/trace-regression

Investigate a newly introduced bug or regression to identify the offending change and formulate a fix.

Agents4

failure-diagnostician

/failure-diagnostician

Analyzes logs, stack traces, and error patterns to diagnose complex system failures. Use when investigating production incidents or cryptic test failures.

Flaky Test Investigator

/flaky-test-investigator

Specialized in analyzing tests that pass and fail intermittently. Uses stress testing, race condition analysis, and environment probing to force determinism.

Reproduction Engineer

/reproduction-engineer

Specialized in reproducing complex bugs with minimal code. Does not fix bugs, only isolates them into standalone, executable tests or scripts.

root-cause-debugger

/root-cause-debugger

Deep-dives into localized bugs to isolate the root cause and implement minimal, precise fixes. Use when encountering unexpected behavior in specific features.

Skills8

bug-hunt

/bug-hunt

Use when reproducing, isolating, and fixing a bug with the smallest safe change.

failure-triage

/failure-triage

Use when confronted with an unknown failure in CI or production, before committing to a deep debugging approach.

flaky-test-investigation

/flaky-test-investigation

Use when tests pass and fail intermittently without code changes, or a test passes alone but fails in the full suite.

incident-readout

/incident-readout

Use when a bug fix or complex debugging session concludes and a blameless post-mortem summary is needed for human review.

log-driven-diagnosis

/log-driven-diagnosis

Use when debugging complex runtime failures, distributed systems, or issues where a local debugger cannot be attached.

Stats

Version0.6.3

ReleasedJul 27, 2026

LanguageTypeScript

Stars6

Forks2

MaintenanceExcellent

LicenseApache-2.0

Last CommitJul 27, 2026

AddedMay 6, 2026

Actions

View on GitHub View README Plugin Marketplace JSON Homepage

Available In

agent-powerups6

Safety Signals

Caution

Uses power tools

Uses Bash, Write, or Edit tools

Tags

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

plugins with native install, marketplace metadata, and apx plugins inspection (apx plugins list)

user-intent profiles with apx profiles for curated skill/plugin sets

Native install is direct for humans. Safety boundaries stay around external tools, secrets, shell profiles, and MCP enablement.

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

Plugins with local-first discovery, validation, native install, and marketplace metadata (apx plugins list)

scripts/

shipped

Validation and tool-check helpers for this repo

examples/

shipped

Minimal safe setup examples

Agent Quickstart

If you are an agent working in a repo with Agent Powerups available, route tasks to capabilities yourself instead of waiting to be told:

Match first. On Claude Code the host already lists skills natively — match the task to the narrowest fitting skill (plus obvious fits like no-fluff). On Codex, Gemini, or generic agents, start with apx discover.

Discover the rest — anything not natively loaded (MCP configs, hooks, AGENTS.md templates, installed-only assets):

apx discover "<the user's task>" --target <codex|claude-code|gemini|generic> --json
apx info <chosen-asset>     # what it is, when to use it, source path, next action

Read, apply, verify. Read the asset's SKILL.md (or file) before applying it; run apx check <asset> only if it declares external requirements; then verify the result against the task.

Gate risky assets. MCP configs and hooks are review-before-use — surface them for approval, never auto-enable.

Quickstart

Using npm (Recommended)

npm install -g agent-powerups apx install claude --full

Agent-Powerups

Agent Powerups

Oh My Zsh for coding agents.

Node.js Version

Quickstart · Agent Quickstart · Plugins · Installation · Security Model · Contributing

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
plugins with native install, marketplace metadata, and apx plugins inspection (apx plugins list)
user-intent profiles with apx profiles for curated skill/plugin sets

Native install is direct for humans. Safety boundaries stay around external tools, secrets, shell profiles, and MCP enablement.

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	Plugins with local-first discovery, validation, native install, and marketplace metadata (`apx plugins list`)
`scripts/`	shipped	Validation and tool-check helpers for this repo
`examples/`	shipped	Minimal safe setup examples

Agent Quickstart

If you are an agent working in a repo with Agent Powerups available, route tasks to capabilities yourself instead of waiting to be told:

Match first. On Claude Code the host already lists skills natively — match the task to the narrowest fitting skill (plus obvious fits like no-fluff). On Codex, Gemini, or generic agents, start with apx discover.

Discover the rest — anything not natively loaded (MCP configs, hooks, AGENTS.md templates, installed-only assets):

apx discover "<the user's task>" --target <codex|claude-code|gemini|generic> --json
apx info <chosen-asset>     # what it is, when to use it, source path, next action

Read, apply, verify. Read the asset's SKILL.md (or file) before applying it; run apx check <asset> only if it declares external requirements; then verify the result against the task.
Gate risky assets. MCP configs and hooks are review-before-use — surface them for approval, never auto-enable.

Quickstart

Using npm (Recommended)

npm install -g agent-powerups
apx install claude --full

debugging-diagnostics

What's Inside

debugging-diagnostics

Popularity

What's Inside

Confidence

README

Agent Powerups

What Is Here

Agent Quickstart

Quickstart

Using npm (Recommended)

Similar Plugins

context7

claude-council

startup-business-analyst

octo

creative-writing

dotnet-skills

More by yeaight7

mcp-development

tool-integrations

spec-quality-gates

documentation-systems

agentic-systems

Agent Powerups

What Is Here

Agent Quickstart

Quickstart

Using npm (Recommended)

Popularity

Health & Quality

More by yeaight7

mcp-development

tool-integrations

spec-quality-gates

documentation-systems

agentic-systems

Similar Plugins

context7

claude-council

startup-business-analyst

octo

creative-writing

dotnet-skills