assess-technical-debt SKILL.md skillA

assess-technical-debt from tobihagemann/turbo is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add tobihagemann/turbo/assess-technical-debt@git:20261022.181a901

Pins git:20261022.181a901 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
tobihagemann/turbo
Path
codex/skills/assess-technical-debt/SKILL.md
Versions recorded
15
Latest version
git:20261022.181a901, committed Oct 22, 2026
First version recorded
Jun 21, 2026
Size
11,564 bytes
Repository stars
417
License
MIT

Assess project-wide structural technical debt: complexity hotspots, deprecated API usage, duplication clusters, architecture rot, and low-value tests. Ranks findings by impact and refactor effort into a report at .turbo/technical-debt.md. Use when the user asks to "assess technical debt", "find technical debt", "review technical debt", "what should we refactor", "find refactoring candidates", "where is the code rot", "what's our worst code", "find low-value tests", or…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Assess Technical Debt

Surface the structural debt that routine review keeps out of scope: long-lived complexity, deprecated APIs, duplication, tangled architecture, and low-value tests that need deliberate refactoring. Project-wide, analysis-only. Ranks each finding by impact and effort and writes `.turbo/technical-debt.md` and `.turbo/technical-debt.html`.

## Task Tracking

At the start, use `update_plan` to track each phase, restating any remaining steps of a parent workflow alongside them:

1. Scope and partition
2. Run debt analysis agents
3. Run `$evaluate-findings` skill
4. Resolve escalated findings
5. Rank and write markdown report
6. Generate HTML report

## Step 1: Scope and Partition

If `$ARGUMENTS` specifies paths, assess those directly (skip the question).

Otherwise, use `request_user_input` to confirm scope:

- **Whole codebase** — assess all source and test files
- **Specific paths** — user provides directories or file patterns

Once scope is determined:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add tobihagemann/turbo/assess-technical-debt@sha256:53b24bcdb8fe0f7c

The line at the top of this page pins the label git:20261022.181a901, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_4ujf7wtlfwlvrxik.svg)](https://markdownregistry.com/a/art_4ujf7wtlfwlvrxik)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 15 versions of this file, between Jun 21, 2026 and Oct 22, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20261022.181a901 latest2026-10-22 181a901 11,564 BA view · diff
git:20261008.aff10272026-10-08 aff1027 11,187 BA view · diff
git:20261006.61ffcb02026-10-06 61ffcb0 10,973 BA view · diff
git:20261001.fc8bd622026-10-01 fc8bd62 10,944 BA view · diff
git:20260927.2ff59962026-09-27 2ff5996 9,152 BA view · diff
git:20260927.f85642c2026-09-27 f85642c 8,973 BA view · diff
git:20260922.bbc32c62026-09-22 bbc32c6 9,005 BA view · diff
git:20260915.66e8d372026-09-15 66e8d37 8,641 BA view · diff
git:20260914.86932fe2026-09-14 86932fe 8,390 BA view · diff
git:20260912.bd2181b2026-09-12 bd2181b 8,175 BA view · diff
git:20260813.cd92d422026-08-13 cd92d42 8,047 BA view · diff
git:20260802.7622cd72026-08-02 7622cd7 7,802 BA view · diff
git:20260727.a40bdb42026-07-27 a40bdb4 7,806 BA view · diff
git:20260721.ff8585d2026-07-21 ff8585d 6,729 BA view · diff
git:20260621.ea1962f2026-06-21 ea1962f 6,626 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (11564 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

tobihagemann/turbo · 417 stars · license MIT · pushed 2026-10-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_4ujf7wtlfwlvrxik
GET https://markdownregistry.com/api/v1/resolve?ref=tobihagemann/turbo/assess-technical-debt
GET https://markdownregistry.com/api/v1/blob/53b24bcdb8fe0f7c66a05f2966ebac116c8f22249e186fd7134419d8cfbda11e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from tobihagemann/turbo

apply-turbo-handoffs SKILL.md skill
tobihagemann/turbo · .claude/skills/apply-turbo-handoffs/SKILL.md · Audit the turbo skill lessons that /self-improve writes into this repo's .turbo/handoff/ from other projects, apply the…
git:20261004.cdcfe2f · audit A · 417 stars
AGENTS.md AGENTS.md file
tobihagemann/turbo · AGENTS.md
git:20260927.fa1ba5a · audit A · 417 stars
CLAUDE.md CLAUDE.md file
tobihagemann/turbo · CLAUDE.md
git:20261002.0f83d5c · audit A · 417 stars
CLAUDE.md@assets CLAUDE.md file
tobihagemann/turbo · assets/CLAUDE.md
git:20260920.5edbbe3 · audit A · 417 stars
AGENTS.md@claude AGENTS.md file
tobihagemann/turbo · claude/AGENTS.md
git:20260726.3cf3297 · audit A · 417 stars
CLAUDE.md@claude CLAUDE.md file
tobihagemann/turbo · claude/CLAUDE.md
git:20261008.aff1027 · audit A · 417 stars
apply-findings SKILL.md skill
tobihagemann/turbo · claude/skills/apply-findings/SKILL.md · Apply findings by making the suggested code changes. Applies accepted verdicts, escalates ambiguous findings to the…
git:20261023.44fa179 · audit A · 417 stars
assess-technical-debt SKILL.md skill
tobihagemann/turbo · claude/skills/assess-technical-debt/SKILL.md · Assess project-wide structural technical debt: complexity hotspots, deprecated API usage, duplication clusters…
git:20261022.181a901 · audit A · 417 stars
changelog-rules SKILL.md skill
tobihagemann/turbo · claude/skills/changelog-rules/SKILL.md · Shared changelog conventions and formatting rules referenced by /create-changelog and /update-changelog. Not typically…
git:20260801.187c292 · audit A · 417 stars
code-style SKILL.md skill
tobihagemann/turbo · claude/skills/code-style/SKILL.md · Enforce existence, reuse, mirror, and symmetry principles to keep new code minimal and consistent with surrounding…
git:20261016.409a05c · audit A · 417 stars
codex-exec SKILL.md skill
tobihagemann/turbo · claude/skills/codex-exec/SKILL.md · Run autonomous task execution using the codex CLI. Use when the user asks to "codex exec", "run codex exec", "execute a…
git:20261008.aff1027 · audit A · 417 stars
commit-rules SKILL.md skill
tobihagemann/turbo · claude/skills/commit-rules/SKILL.md · Shared commit message rules and technical constraints for skills that write commits. Not typically invoked directly.
git:20260927.8a693f4 · audit A · 417 stars

Every file in tobihagemann/turbo

Other files named assess-technical-debt

assess-technical-debt SKILL.md skill
tobihagemann/turbo · claude/skills/assess-technical-debt/SKILL.md · Assess project-wide structural technical debt: complexity hotspots, deprecated API usage, duplication clusters…
git:20261022.181a901 · audit A · 417 stars

Browse by kind, by grade A, or by owner.