fastapi-debug

fastapi-debug is a skill for Claude Code from steph-dove/klaussy-agents. It costs 51 tokens per session (1,424 once invoked), scanned A, original, MIT.

A structured guide for finding the cause of a reported software error or unexpected behavior.

In plain words
What is it for?
It helps reproduce bugs, trace the code involved, identify the root cause, write a test that captures the failure, apply a fix, and run the full test suite.
Why use it?
It prevents guessing at a fix before the problem is reproduced and understood. It first investigates the failure, then adds a test and verifies the correction.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions CLAUDE.md; installed under .agents/ (shared by several agents).

Part of the klaussy plugin — 79 skills, 3 hooks, 1 MCP server shipped together

Good fit It helps reproduce bugs, trace the code involved, identify the root cause, write a test that captures the failure, apply a fix, and run the full test suite.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/steph-dove/klaussy-agents/fastapi-debug
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.

Any agent
npx skills add steph-dove/klaussy-agents --skill fastapi-debug
Clone the repo
git clone --depth 1 https://github.com/steph-dove/klaussy-agents

Made for: Claude Code.

Or install klaussy, the plugin that ships this one along with the rest of its 79 skills, 3 hooks, 1 MCP server.

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 fastapi-debug

README.md
[![agentmods](https://agentmods.dev/badge/skills/steph-dove/klaussy-agents/fastapi-debug.svg)](https://agentmods.dev/skills/steph-dove/klaussy-agents/fastapi-debug)
Your own site
<a href="https://agentmods.dev/skills/steph-dove/klaussy-agents/fastapi-debug"><img src="https://agentmods.dev/badge/skills/steph-dove/klaussy-agents/fastapi-debug.svg" alt="Measured on agentmods" height="20"></a>
Per session 51 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,424 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 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.1 $0.00051 $0.01424
Opus 5 $0.00026 $0.00712
Sonnet 5 $0.00010 $0.00285
Haiku 4.5 $0.00005 $0.00142

Measured 8d ago against content hash ae32bb2c8902, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

fastapi-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 8d 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

Copies of this mod

2 near-identical copies found in the catalogue:

examples/fastapi/.agents/skills/fastapi-debug/SKILL.md · 93 lines

How it starts

The opening of the file, as written. The whole thing — 93 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Debug the error or issue the user described. Do NOT jump to a fix. Follow these phases in order.


Phase 1: Reproduce and Understand

  1. Read CLAUDE.md for project structure, test commands, and known pitfalls.
  2. Read any .claude/rules/*.md whose paths: glob matches the file(s) where the bug surfaces. Path-scoped rules often encode the conventions a fix needs to respect.
  3. Understand the failure. What exactly is going wrong? Read the error message, stack trace, or described behavior carefully. Identify:
    • What is the expected behavior?
    • What is the actual behavior?
    • When did it start? Run git log --oneline -10 to check for recent changes that could be the cause.
  4. Reproduce it. If there's a test command or way to trigger the bug, run it now. If you can't reproduce it, say so before proceeding — a fix you can't verify is a guess.

Phase 2: Diagnose

Do NOT write any fix yet. Investigate read-only until you understand the root cause.

  1. Find the code path. Starting from the error location or the described behavior, trace the execution. The three operations below are independent — issue them as a single batch of parallel tool calls, not sequentially:
    • Grep for the error message, function name, or component.
    • Read the file where the failure occurs — the full file, not just the function.
    • Trace backwards: what calls this code? What data does it receive?
  2. Find the actual data source. If the bug involves wrong values, read the query or data access that produces them. Do not assume — read the actual code.
  3. Form 3–5 competing hypotheses for the root cause and rank them by likelihood. Do not anchor on the first plausible explanation — the obvious one is often itself a symptom. For each hypothesis, note what evidence would confirm it and what would kill it.
  4. Gather runtime evidence — don't conclude from static reading alone. Where practical, add temporary logging, inspect the actual runtime values / server logs, or step through the repro, and see which hypothesis the real data supports. Reading code suggests a cause; runtime behavior confirms it. (Skipping this is the classic failure mode: rewriting logic to fix a guessed cause without ever checking the actual data.)
  5. Identify the root cause. Ask yourself:
    • Is this a logic error, a data error, or a state error?
    • Is this a regression from a recent change? Check git diff and git log.
    • Could this be caused by something upstream of where the error appears?

Read the full file on GitHub · 93 lines

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. 8d ago First seen · 93 lines · 51 tokens per session scan A ae32bb2c8902

Subscribe to this mod's changes

fastapi-debug is a skill published in the GitHub repository steph-dove/klaussy-agents (16 stars, last pushed 11d ago), licensed MIT. It adds 51 tokens to every session and 1,424 once invoked, about $0.0003 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-30.