agent-virtual-office: Skill for Codex

.agents/skills/systematic-debugging/SKILL.md

systematic-debugging is a skill for Codex from KbWen/agent-virtual-office. It costs 28 tokens per session (431 once invoked), scanned A, a copy of systematic-debugging, MIT.

A four-phase method for finding the root cause of software bugs: observe, form hypotheses, verify them, and then fix the problem.

In plain words
What is it for?
Use it for hotfixes, flaky tests, cross-module problems, and bugs that seemed fixed without a clear explanation.
Why use it?
It prevents unverified patches and makes the cause, reproduction steps, and evidence for a fix explicit.

Skill for Codex

Written for Codex: agents/openai.yaml present. Also seen: installed under .agents/ (shared by several agents).

This is KbWen/agent-virtual-office's own configuration. It tells Codex how to work on agent-virtual-office itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything agent-virtual-office configures →

Reuse

Borrowing it

Nothing to install: this file belongs to KbWen/agent-virtual-office. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/KbWen/agent-virtual-office/main/.agents/skills/systematic-debugging/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/KbWen/agent-virtual-office

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for systematic-debugging

README.md
[![agentmods](https://agentmods.dev/badge/skills/kbwen/agent-virtual-office/systematic-debugging/github.svg)](https://agentmods.dev/skills/kbwen/agent-virtual-office/systematic-debugging)
Your own site
<a href="https://agentmods.dev/skills/kbwen/agent-virtual-office/systematic-debugging"><img src="https://agentmods.dev/badge/skills/kbwen/agent-virtual-office/systematic-debugging/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for systematic-debugging

Your own site · 80×15
<a href="https://agentmods.dev/skills/kbwen/agent-virtual-office/systematic-debugging"><img src="https://agentmods.dev/badge/skills/kbwen/agent-virtual-office/systematic-debugging.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 28 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 431 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 100% copy Near-identical to another mod 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.1 $0.00028 $0.00431
Opus 5.5 $0.00011 $0.00172
Sonnet 5.5 $0.00006 $0.00086
Haiku 4.5 $0.00003 $0.00043

Measured 1mo ago against content hash 62c160464493, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

systematic-debugging 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 1mo ago.

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.

Origin

This is a copy

100% identical to systematic-debugging — 2 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.agents/skills/systematic-debugging/SKILL.md · 57 lines

What it actually says

Systematic Debugging

Overview

The core of systematic debugging is: understand first, then fix. When encountering a bug, clarify symptoms, reproduction conditions, and blast radius. Draw hypotheses, verify them with experiments to isolate the root cause, and only then submit a minimal, verifiable fix.

Ironclad Rules

  1. No random patching: Do not submit fixes without root cause evidence.
  2. Change one variable at a time: Prevent unexplainable results from touching multiple areas at once.
  3. Fixes MUST include evidence: Include reproduction steps, verification, and regression results.

When to Use

  • Hotfix incident response.
  • Flaky tests.
  • Cross-module anomalies that aren't intuitively obvious.
  • Any "fixed but I don't know why" risk scenarios.

Four-Phase Process

Phase 1: Observe

  • Precisely record error messages, timestamps, and input conditions.
  • Create a Minimal Reproducible Example (MRE).
  • Mark the blast radius (affected modules/users).

Phase 2: Hypothesize

  • Propose 1–3 testable root cause hypotheses.
  • Design "falsifiable" checks for each hypothesis.
  • Prioritize high-probability, low-cost verifiable items.

Phase 3: Verify

  • Run experiments and retain output logs.
  • Adjust only one variable to confirm causality.
  • Remove falsified hypotheses to converge on the most likely root cause.

Phase 4: Fix

  • Implement a Minimal Fix.
  • Add a Regression Test.
  • Verify: The original error disappears AND existing behavior is not broken.

Common Mistakes

  • Modifying code before reproducing the issue.
  • Modifying too many files at once, failing to locate the effective fix point.
  • Treating "accidental passes" as root cause resolved.
  • Lacking regression tests, causing similar issues to happen again.
Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 1mo ago First seen · 57 lines · 28 tokens per session scan A 62c160464493

Subscribe to this mod's changes

systematic-debugging is a skill published in the GitHub repository KbWen/agent-virtual-office (61 stars, last pushed 2d ago), licensed MIT. It adds 28 tokens to every session and 431 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. It is 100% identical to systematic-debugging, differing in 2 lines, and is treated as a copy.

Related

Other skills, from other repositories

devtools-bidirectional

Two-way event patterns between devtools panel and application. App-to-devtools observation, devtools-to-app commands, time-travel debugging with snapshots and revert. structuredClone for snapshot safety, distinct event suffixes for observation vs commands, serializable payloads only.

TanStack/devtools · 59 tokens

devtools-instrumentation

Analyze library codebase for critical architecture and debugging points, add strategic event emissions. Identify middleware boundaries, state transitions, lifecycle hooks. Consolidate events (1 not 15), debounce high-frequency updates, DRY shared payload fields, guard emit() for production. Transparent server/client…

TanStack/devtools · 64 tokens

code_explorer

Explores the repository to locate primary source files, coupled UI components, and test files for bug reports or feature requests.

google-gemini/gemini-cli · 28 tokens

migrate-oxlint

Guide for migrating a project from ESLint to Oxlint. Use when asked to migrate, convert, or switch a JavaScript/TypeScript project's linter from ESLint to Oxlint.

oxc-project/oxc · 44 tokens

therapeutic-ifs

Unified inner work engine: Schema deconstruction (diagnosis) + IFS therapy (treatment). Absorbs: schema-deconstruction.

winstonkoh87/Athena-Public · 34 tokens

dev-fix

Unified developer workflow for fixing bugs. Analyzes issue-tracker context, cross-checks docs/code, proposes a solution, implements the fix, verifies locally, and delivers a PR/MR.

HoangNguyen0403/agent-skills-standard · 43 tokens