Tech Debt Register
Donchitos/Claude-Code-Game-Studios
Scans a codebase for debt indicators, sorts findings into six debt categories and maintains a prioritized register you can add to, re-rank and report on.
Register a deferred decision in the debt registry. An agent skill from hashgraph-online/awesome-codex-plugins.
Apache-2.0Auto-check passed
Install Add
$ npx skills add hashgraph-online/awesome-codex-plugins --skill add -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install hashgraph-online/awesome-codex-plugins add --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/bcanfield/agentic-tech-debt/skills/add .claude/skills/add && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "add" agent skill from https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/bcanfield/agentic-tech-debt/skills/add into .claude/skills/add/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/bcanfield/agentic-tech-debt/skills/addType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add hashgraph-online/awesome-codex-plugins --skill add -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install hashgraph-online/awesome-codex-plugins add --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/bcanfield/agentic-tech-debt/skills/add .agents/skills/add && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "add" agent skill from https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/bcanfield/agentic-tech-debt/skills/add into .agents/skills/add/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add hashgraph-online/awesome-codex-plugins --skill add -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install hashgraph-online/awesome-codex-plugins add --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/bcanfield/agentic-tech-debt/skills/add .cursor/skills/add && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "add" agent skill from https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/bcanfield/agentic-tech-debt/skills/add into .cursor/skills/add/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/hashgraph-online/awesome-codex-plugins.git --path plugins/bcanfield/agentic-tech-debt/skills/add--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add hashgraph-online/awesome-codex-plugins --skill add -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install hashgraph-online/awesome-codex-plugins add --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/bcanfield/agentic-tech-debt/skills/add .gemini/skills/add && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "add" agent skill from https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/bcanfield/agentic-tech-debt/skills/add into .gemini/skills/add/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install hashgraph-online/awesome-codex-plugins addInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add hashgraph-online/awesome-codex-plugins --skill add -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/bcanfield/agentic-tech-debt/skills/add .github/skills/add && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "add" agent skill from https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/bcanfield/agentic-tech-debt/skills/add into .github/skills/add/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add hashgraph-online/awesome-codex-plugins --skill add -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install hashgraph-online/awesome-codex-plugins add --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/bcanfield/agentic-tech-debt/skills/add .opencode/skills/add && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "add" agent skill from https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/bcanfield/agentic-tech-debt/skills/add into .opencode/skills/add/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
add- GitHub stars
- 1.2k
- Token cost
- ~871 tokens
- SKILL.md length
- 315 words
- Files
- 2 (incl. scripts)
- Skills in repo
- 736
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Register a deferred decision in the debt registry. An agent skill from hashgraph-online/awesome-codex-plugins.
- Not a marker scan
- SKILL.md covers The call, Slug, Schema notes and Drops, plus 1 more section
- Runs Python scripts from its folder; calls python3
- Whenever a future reader would ask why this way?: an unmade decision
What it does
Add is an agent skill from hashgraph-online/awesome-codex-plugins. Register a deferred decision in the debt registry. Trigger by judgment, not a marker scan, whenever a future reader would ask "why this way?": an unmade decision, stub, loosened type, bypassed check, swallowed error, a default picked "for now", or a TODO/FIXME/HACK/XXX marker. Trigger immediately whenever you defer work, or when the user invokes $add. Over-register freely; the developer drops with "drop A", "drop A,C", or "drop all".
Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/register.py`).
The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.
When your agent uses it
- Not a marker scan
- Whenever a future reader would ask why this way?: an unmade decision
- Swallowed error
- A default picked for now
Example prompts
- “why this way?”
- “for now”
- “drop A”
- “/add”
Requirements
- Python 3
What it can do on your machine
Read from SKILL.md and the folder at commit 16b4156. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Add loads about 871 tokens when it runs. Until then it costs about 110 tokens; SKILL.md has 315 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from hashgraph-online/awesome-codex-plugins at commit 16b4156, republished under its Apache-2.0 licence (© hashgraph-online). 315 words, ~871 tokens.
Download SKILL.mdSave it as
.claude/skills/add/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- add
- description
- Register a deferred decision in the debt registry. Trigger by judgment, not a marker scan, whenever a future reader would ask "why this way?": an unmade decision, stub, loosened type, bypassed check, swallowed error, a default picked "for now", or a TODO/FIXME/HACK/XXX marker. Trigger immediately whenever you defer work, or when the user invokes $add. Over-register freely; the developer drops with "drop A", "drop A,C", or "drop all".
add — register a tech-debt entry
Call the bundled register.py via Bash — it lives in this skill's scripts/ directory, so reference it with the relative path below (Codex resolves it against the skill root). The helper writes the entry under the repo's detected registry dir (default docs/debt/), assigns a short batch letter (A, B, C…), and prints exactly one line: +1 entry: <slug> (<letter>). That stdout IS the user-facing announcement — add no commentary before or after.
The call
python3 scripts/register.py \
--slug <slug> \
--principal <effort, e.g. 2d, 1w, unknown> \
--interest <ongoing cost, e.g. "+30min/incident", unknown> \
--hotspot <path or module, e.g. pricing/engine.ts, unknown> \
--business-capability <e.g. checkout, billing, unknown> \
--payoff-trigger <concrete trigger, or "unknown"> \
--quadrant <reckless-inadvertent|reckless-deliberate|prudent-inadvertent|prudent-deliberate> \
--category <migration|documentation|testing|code_quality|dead_code|code_rot|expertise|release|infrastructure|planning> \
--ai-authored <true|false> <<'EOF'
<body: 2-5 sentences — what the debt is, why it exists, observed symptoms>
EOFThe helper:
- Generates the timestamp
iditself (nodatecall needed). - Resolves filename collisions when two registrations land in the same second.
- Tracks the letter mapping in
~/.cache/debt-ops/cache/<repo-hash>/current-turn.txt(override the base withDEBT_OPS_CACHE) so the user can drop by letter.
Slug
1–4 word kebab-case label of what the debt is. Examples: cancelled-promotion-callback, legacy-auth-shim, unfinished-rate-limiter. Keep it short — the body carries the context.
Schema notes
- Quadrant (Fowler):
reckless-inadvertent(didn't know better),reckless-deliberate(knew, did it anyway),prudent-inadvertent(learned afterward),prudent-deliberate(deliberate, with a payoff plan). - Category (Google / Jaspan-Green): pick the closest match.
- payoff_trigger: unknown is first-class. Don't manufacture a trigger to fill the field —
unknownages into stale review and that's the point. - ai_authored: true is the leading behavioral signal — be honest.
Drops
drop A,drop A,C,drop all— the user types this; a UserPromptSubmit hook deletes the matching entries and surfaces a one-line confirmation. You don't act on those.drop itordrop <slug>— you delete it yourself:rm <registry-dir>/<id>-<slug>.md(the registry dir named in Discipline 3; defaultdocs/debt/). Treat dropping as cheap — over-registering is the intended posture.
Don't
- Don't ask the developer for confirmation before writing. Discipline 1 says "no permission prompt; just do it."
- Don't write the file directly with an editor tool — letter assignment depends on going through
register.py. - Don't echo or paraphrase the helper's output. The Bash tool result is already visible to the user.
- Don't fill
payoff_triggerwith a guess to seem certain.
© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file (scripts) in plugins/bcanfield/agentic-tech-debt/skills/add of hashgraph-online/awesome-codex-plugins.
- SKILL.md
- scripts/register.py
Open the folder on GitHubat commit 16b4156
Compare with similar skills
Add next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Add this skillhashgraph-online/awesome-codex-plugins | 1.2k | — | ~871 | Automated safety check: Pass | Apache-2.0 | |
| Tech Debt RegisterDonchitos/Claude-Code-Game-Studios | 26k | — | ~2.4k | Automated safety check: Pass | MIT | |
| Technical Debt Registermohitagw15856/pm-claude-skills | 1.4k | — | ~3.5k | Automated safety check: Pass | MIT | |
| Brooks Debtsickn33/agentic-awesome-skills | 47k | 1 repos | ~542 | Automated safety check: Pass | MIT | |
| Tech Debt Auditcode-yeongyu/oh-my-openagent | 70k | — | ~2.4k | Automated safety check: Notes | Custom licence | |
| Iot Registerruvnet/ruflo | 74k | — | ~263 | Automated safety check: Pass | MIT |
Similar skills
Technical Debt Register
mohitagw15856/pm-claude-skills
Document and prioritize a technical debt backlog with business impact, effort estimates, and resolution strategy.
Brooks Debt
sickn33/agentic-awesome-skills
Tech debt assessment that identifies, classifies, and prioritizes maintainability problems — helping teams build a refactoring roadmap — drawing on twelve classic engineering books.
Tech Debt Audit
code-yeongyu/oh-my-openagent
Audits a codebase for technical debt across nine dimensions and writes TECH_DEBT_AUDIT.md with file-cited findings, severity, effort estimates and priorities.
Iot Register
ruvnet/ruflo
Register a Cognitum Seed device by endpoint and establish agent bridge
Code Refactoring Tech Debt
sickn33/agentic-awesome-skills
Identify technical debt from actual code and change history, estimate its impact, and prioritize bounded improvements with explicit assumptions.
More from hashgraph-online/awesome-codex-plugins
All 736 skills in this repoAnime Reaction Gif
hashgraph-online/awesome-codex-plugins
Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.
Calibredb
hashgraph-online/awesome-codex-plugins
Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).
Rust API Test Harness
hashgraph-online/awesome-codex-plugins
A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…
Art
hashgraph-online/awesome-codex-plugins
Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…
Calle
hashgraph-online/awesome-codex-plugins
Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.
Game Balance Economy
hashgraph-online/awesome-codex-plugins
Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.
Questions about Add
What does Add do?
Register a deferred decision in the debt registry. An agent skill from hashgraph-online/awesome-codex-plugins. Add is an agent skill from hashgraph-online/awesome-codex-plugins. Register a deferred decision in the debt registry.
When should I use Add?
Add fits situations like: not a marker scan; whenever a future reader would ask why this way?: an unmade decision; swallowed error; A default picked for now.
How do I install Add in Claude Code?
Run `npx skills add hashgraph-online/awesome-codex-plugins --skill add -a claude-code`. Or copy the skill folder (plugins/bcanfield/agentic-tech-debt/skills/add in hashgraph-online/awesome-codex-plugins) into .claude/skills/add in your project. Claude Code loads it when a task matches its description.
How do I install Add in Codex?
Run `npx skills add hashgraph-online/awesome-codex-plugins --skill add -a codex`. Or copy the skill folder (plugins/bcanfield/agentic-tech-debt/skills/add in hashgraph-online/awesome-codex-plugins) into .agents/skills/add in your project. Codex loads it when a task matches its description.
Can I use Add in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill add -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add, .gemini/skills/add, .github/skills/add and .opencode/skills/add in your project.
What does Add need to run?
Going by SKILL.md and its folder, Add needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.
Does Add access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Add safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Add use?
Add is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Add use?
About 871 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Add?
Skills that share tags, products or a category with Add: Tech Debt Register (Donchitos/Claude-Code-Game-Studios, 26k stars), Technical Debt Register (mohitagw15856/pm-claude-skills, 1.4k stars), Brooks Debt (sickn33/agentic-awesome-skills, 47k stars) and Tech Debt Audit (code-yeongyu/oh-my-openagent, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Add?
hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,232 GitHub stars. The repository holds 736 skills in this directory. The repository was last updated on October 6, 2026.
Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.