debugging

A guide for tracing a bug through a codebase to find its likely root cause. It follows callers, called code, and execution flows around the location where the problem appears.

In plain words
What is it for?
Use it with bug reports, stack traces, unexpected behavior, or performance problems to identify affected flows and a likely fix location.
Why use it?
It helps narrow a symptom to the code that likely causes it, especially when the path through the program is not obvious.

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/cdeust/ai-architect-mcp/debugging
Any agent
npx skills add cdeust/ai-architect-mcp --skill debugging
Clone the repo
git clone --depth 1 https://github.com/cdeust/ai-architect-mcp

Made for: Claude Code, Codex.

Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 190 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.00000 $0.00190
Opus 5 $0.00000 $0.00095
Sonnet 5 $0.00000 $0.00038
Haiku 4.5 $0.00000 $0.00019

Measured 2d ago against content hash 1cfe82bc4d73, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

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 2d 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.

ai-codebase-intelligence/skills/debugging/SKILL.md · 29 lines

What it actually says

Debugging Skill

Purpose

Trace bugs through the codebase using graph analysis to find root causes efficiently.

When to Use

  • Bug reports with stack traces
  • Unexpected behavior requiring call chain analysis
  • Performance issues requiring hotspot identification

Operations

  1. Locate: Use ai_architect_codebase_query to find the symptom location
  2. Context: Get 360° view of the affected symbol
  3. Trace upstream: Use ai_architect_codebase_impact with direction=upstream
  4. Trace downstream: Check what the affected code calls
  5. Narrow: Cross-reference with process membership to find the execution flow

Workflow

Query symptom → Get context → Impact upstream → Check callers → Identify root cause

Output

  • Root cause identification with confidence level
  • Affected execution processes
  • Recommended fix location
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. 2d ago First seen · 29 lines · 0 tokens per session scan A 1cfe82bc4d73

Subscribe to this mod's changes

debugging is a skill published in the GitHub repository cdeust/ai-architect-mcp (1 stars, last pushed 4mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 190 tokens. 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

nexus-mapper

Generate a persistent .nexus-map/ knowledge base that lets any AI session instantly understand a codebase's architecture, systems, dependencies, and change hotspots. Use when starting work on an unfamiliar repository, onboarding with AI-assisted context, preparing for a major refactoring initiative, or enabling…

Haaaiawd/Nexus-skills · 118 tokens

nexus-query

Precise, instant code structure queries for active development — answer 'who depends on this interface before I refactor it', 'how many modules break if I change this', 'what is the real impact radius of this feature change', 'which module is the true high-coupling hotspot in this legacy codebase'. Essential before…

Haaaiawd/Nexus-skills · 119 tokens

API Documentation Generator

AI-powered API documentation generation tool that auto-generates comprehensive API docs from source code, including OpenAPI/Swagger specs, Postman collections, and markdown documentation with examples and authentication details.

XSpoonAi/spoon-awesome-skill · 41 tokens

repomix

Pack and analyze codebases into AI-friendly single files using Repomix. Use when the user wants to explore repositories, analyze code structure, find patterns, check token counts, or prepare codebase context for AI analysis. Supports both local directories and remote GitHub repositories.

yamadashy/repomix · 58 tokens

hive.worker-delegation

Concrete patterns for breaking colony work into parallel worker jobs via runplaybook — when fan-out helps, how to model the goal as a tracker table, write the worker skill, author the playbook, pilot, and let convergence retry/resume the gap.

aden-hive/hive · 58 tokens

hive.chart-creation-foundations

Required reading whenever any chart tool is available. Teaches the one-tool embedding contract (call chartrender → live chart appears in chat AND a downloadable PNG lands in the queen session dir), the ECharts (data viz) vs Mermaid (structural diagrams) decision, the BI/financial-grade aesthetic baseline (no…

aden-hive/hive · 133 tokens