tech-debt

tech-debt is a skill for Claude Code from Donchitos/Claude-Code-Game-Studios. It costs 33 tokens per session (1,267 once invoked), scanned A, original, MIT.

A workflow for finding, recording, grouping, and prioritizing technical debt in a codebase. Technical debt is work postponed through shortcuts, outdated code, missing tests, or weak documentation.

In plain words
What is it for?
Use it to scan for debt, add entries, reprioritize the register, or generate a status report.
Why use it?
Untracked debt makes maintenance problems harder to see and schedule. This creates a shared record of issues such as TODOs, duplication, complexity, deprecated code, and dependency problems.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: model in frontmatter; names the AskUserQuestion tool.

About the project

Claude Code Game Studios is a setup that organizes Claude Code into a coordinated game-development team of specialized AI agents. It supports game projects across design, programming, art, audio, narrative, quality assurance, and production, with skills and workflows for coordinating that work.

Donchitos/Claude-Code-Game-Studios · 24,838 stars · on GitHub

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/donchitos/claude-code-game-studios/tech-debt
Any agent
npx skills add Donchitos/Claude-Code-Game-Studios --skill tech-debt
Clone the repo
git clone --depth 1 https://github.com/Donchitos/Claude-Code-Game-Studios

Made for: Claude Code.

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 tech-debt

README.md
[![agentmods](https://agentmods.dev/badge/skills/donchitos/claude-code-game-studios/tech-debt.svg)](https://agentmods.dev/skills/donchitos/claude-code-game-studios/tech-debt)
Your own site
<a href="https://agentmods.dev/skills/donchitos/claude-code-game-studios/tech-debt"><img src="https://agentmods.dev/badge/skills/donchitos/claude-code-game-studios/tech-debt.svg" alt="Measured on agentmods" height="20"></a>
Per session 33 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,267 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.1 $0.00033 $0.01267
Opus 5 $0.00016 $0.00633
Sonnet 5 $0.00007 $0.00253
Haiku 4.5 $0.00003 $0.00127

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

Security

Grade A, and why

tech-debt 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 3d 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:

  • tech-debt — 91% identical, 18 lines differ
  • tech-debt — 88% identical, 25 lines differ
.claude/skills/tech-debt/SKILL.md · 141 lines

How it starts

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

Phase 1: Parse Subcommand

Determine the mode from the argument:

  • scan — Scan the codebase for tech debt indicators
  • add — Add a new tech debt entry manually
  • prioritize — Re-prioritize the existing debt register
  • report — Generate a summary report of current debt status

If no subcommand is provided, output usage and stop. Verdict: FAIL — missing required subcommand.


Phase 2A: Scan Mode

Search the codebase for debt indicators:

  • TODO comments (count and categorize)
  • FIXME comments (these are bugs disguised as debt)
  • HACK comments (workarounds that need proper solutions)
  • @deprecated markers
  • Duplicated code blocks (similar patterns in multiple files)
  • Files over 500 lines (potential god objects)
  • Functions over 50 lines (potential complexity)

Categorize each finding:

  • Architecture Debt: Wrong abstractions, missing patterns, coupling issues
  • Code Quality Debt: Duplication, complexity, naming, missing types
  • Test Debt: Missing tests, flaky tests, untested edge cases
  • Documentation Debt: Missing docs, outdated docs, undocumented APIs
  • Dependency Debt: Outdated packages, deprecated APIs, version conflicts
  • Performance Debt: Known slow paths, unoptimized queries, memory issues

Present the findings to the user.

Ask: "May I write these findings to docs/tech-debt-register.md?"

If yes, update the register (append new entries, do not overwrite existing ones). Verdict: COMPLETE — scan findings written to register.

If no, stop here. Verdict: BLOCKED — user declined write.


Phase 2B: Add Mode

Ask the user for the description, affected files, and impact if left unfixed (plain text prompts).

Then use AskUserQuestion to collect the category:

  • Prompt: "What category does this tech debt belong to?"
  • Options:
    • [A] Architecture Debt — wrong abstractions, missing patterns, coupling issues
    • [B] Code Quality Debt — duplication, complexity, naming, missing types
    • [C] Test Debt — missing tests, flaky tests, untested edge cases
    • [D] Documentation Debt — missing/outdated docs, undocumented APIs
    • [E] Dependency Debt — outdated packages, deprecated APIs, version conflicts
    • [F] Performance Debt — known slow paths, memory issues, unoptimized queries

Read the full file on GitHub · 141 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. 3d ago First seen · 141 lines · 33 tokens per session scan A bebf9faf308e

Subscribe to this mod's changes

tech-debt is a skill published in the GitHub repository Donchitos/Claude-Code-Game-Studios (24,838 stars, last pushed 3mo ago), licensed MIT. It adds 33 tokens to every session and 1,267 once invoked, about $0.0002 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-09-03.

Related

Other skills, from other repositories

ln-51-opportunity-evaluator

Evaluates new product opportunities using demand, channels, competition, and economics. Not for committed-backlog or implementation planning.

levnikolaevich/claude-code-skills · 32 tokens

github-triage

Read-only GitHub triage for issues AND PRs. 1 item = 1 background task (category: quick). Analyzes all open items and writes evidence-backed reports to /tmp/{datetime}/. Every claim requires a GitHub permalink as proof. NEVER takes any action on GitHub - no comments, no merges, no closes, no labels. Reports only.…

code-yeongyu/oh-my-openagent · 104 tokens

refactoring-assistant

Guide refactoring decisions and large-scale code improvements. Use when: refactoring code, legacy modernization, technical debt, rewrite decisions. Keywords: refactor, rewrite, legacy, strangler, technical debt, 重構, 重寫, 技術債.

ValorVie/custom-skills · 57 tokens

spec-driven-dev

Guide Spec-Driven Development (SDD) workflow for planning changes before implementation. Use when: creating specs, proposals, planning features, using OpenSpec or similar tools. Keywords: spec, specification, SDD, proposal, openspec, design doc, 規格, 提案, 設計文件.

ValorVie/custom-skills · 67 tokens

code-review-assistant

Systematic code review checklist and pre-commit quality gates for PRs. Use when: reviewing pull requests, checking code quality, before committing code. Keywords: review, PR, pull request, checklist, quality, commit, 審查, 檢查, 簽入.

ValorVie/custom-skills · 64 tokens

requirement-assistant

Guide requirement writing, user story creation, and feature specification. Use when: writing requirements, user stories, issues, feature planning. Keywords: requirement, user story, issue, feature, specification, 需求, 功能規劃, 規格.

ValorVie/custom-skills · 57 tokens