oad/debug

A step-by-step guide for investigating bugs, regressions, user sessions, and runtime problems in an application.

In plain words
What is it for?
Use it to triage a report, choose the relevant backend, frontend, desktop, command-line, agent, or provider path, reproduce the problem, and diagnose it from evidence and code.
Why use it?
It turns vague reports into a small, reproducible case supported by logs, responses, events, tests, or interface state.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/evoelsewhere/evoflux/debug
Any agent
npx skills add evoelsewhere/evoflux --skill debug
Clone the repo
git clone --depth 1 https://github.com/evoelsewhere/evoflux

Made for: Claude Code, Codex.

Per session 20 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 463 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00020 $0.00463
Opus 5 $0.00010 $0.00231
Sonnet 5 $0.00004 $0.00093
Haiku 4.5 $0.00002 $0.00046

Measured yesterday against content hash ce6ca6365b72, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

oad/debug scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.evoflux/skills/oad/debug/SKILL.md · 42 lines

What it actually says

Debug the reported issue.

Workflow:

  1. Triage the report

    • Extract the symptom, expected behavior, reproduction steps, affected surface (backend/frontend/desktop/agent/provider), session id, workspace, model, logs, and timing clues.
    • If the report is ambiguous, inspect available evidence first; ask only when a missing decision blocks safe progress.
  2. Choose the fastest evidence path

    • Live session / agent behavior: use the API endpoints directly or the test suite:
      uv run pytest tests/agent/mode/team/ -q
      
    • Backend/API issue: hit the smallest route/service path, inspect logs, then add/adjust pytest coverage.
    • Frontend issue: inspect relevant components/hooks/stores, run focused bun checks/tests, and use existing UI state patterns.
    • Desktop/CLI/provider issue: inspect the specific command/provider path and environment assumptions.
  3. Reproduce narrowly

    • Recreate the smallest scenario that demonstrates the bug.
    • Match the user's mode/workspace/model/message sequence when relevant.
    • Capture durable evidence: raw HTTP response, persisted history, SSE events, logs, failing test output, or UI state.
  4. Diagnose from code and evidence

    • Search for existing patterns before editing.
    • Identify the boundary that failed: route validation, persistence, queueing, stream emission, agent loop, hook, tool, provider, frontend store, or renderer.
    • Preserve unrelated work; do not reset or overwrite changes you did not make.
  5. Fix surgically

    • Make the smallest change that addresses the proven root cause.
    • Add or update focused regression coverage at the closest layer.
    • Update related docs only when behavior, API contract, or operator workflow changed.
  6. Verify and report

    • Re-run the reproduction and the focused tests/checks for touched areas.
    • If feasible, run the repository's standard lint/type/test commands for the changed surface.
    • Report root cause, changed files, checks run with results, and any remaining risk or unverified area.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 42 lines · 20 tokens per session scan A ce6ca6365b72

Subscribe to this mod's changes

oad/debug is a skill published in the GitHub repository evoelsewhere/evoflux (5 stars, last pushed 5d ago), licensed Apache-2.0. It adds 20 tokens to every session and 463 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

kane-cli

Browser automation + AI test authoring via kane-cli - run browser objectives, generate & refine test scenarios/cases from a description, design requirement-linked test suites from a PRD/spec (assurance), parse NDJSON output, inspect logs, save runnable test.md. Use for any task requiring a real browser (navigate…

LambdaTest/kane-cli · 159 tokens

rove

Use when controlling Rove tasks, parallel coding attempts, hosted agent sessions, task lifecycle, or the daemon-owned issue tracker from a shell. Also the ONLY channel for messaging another agent session on this machine — rove api send, never a peer/MCP side channel.

Sma1lboy/rove · 56 tokens

E2E Testing Nori Skillsets Subcommands

Use when you need to interactively test a nori-skillsets CLI subcommand end-to-end via tmux, with full filesystem isolation.

tilework-tech/nori-skillsets · 39 tokens

release

Autonomously cut a Rove (@sma1lboy/rove) release end-to-end — detect the semver bump from pending changesets (flagging an upstream minor you didn't intend), run the release gates, bump/tag/push via scripts/release.sh, then poll the GitHub Actions Release workflow with gh until npm publish completes, diagnosing CI…

Sma1lboy/rove · 155 tokens

hyperframes-cli

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, or remove-background, or when troubleshooting the…

Sma1lboy/rove · 101 tokens

changelog-generator

Draft Rove release notes as Changesets. Writes user-facing entries as .changeset/.md files for @sma1lboy/rove (consumed into packages/kobe/CHANGELOG.md at release time). Use when the user asks for "changelog", "release notes", "what changed", "add a changeset", or before cutting a version. Enforces Rove's no-soft-wrap…

Sma1lboy/rove · 101 tokens