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
claude/skills/assess-technical-debt/SKILL.md
Versions recorded
16
Latest version
git:20261022.181a901, committed Oct 22, 2026
First version recorded
Jul 27, 2026
Size
11,528 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 `TaskCreate` to create a task for each phase:

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 `AskUserQuestion` to confirm scope:

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

Once scope is determined:

1. Glob for source and test files in the selected scope. Exclude generated and vendored directories (`node_modules/`, `dist/`, `build/`, `vendor/`, `__pycache__/`, `.build/`, `DerivedData/`, `target/`, `.tox/`, and others appropriate to the project).
…

Read the whole file at its exact version.

How to install

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

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_qc6vppj6xvms6k27.svg)](https://markdownregistry.com/a/art_qc6vppj6xvms6k27)

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

Versions

The registry has recorded 16 versions of this file, between Jul 27, 2026 and Oct 22, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261022.181a901 latest2026-10-22 181a901 11,528 BA view · diff
git:20261008.aff10272026-10-08 aff1027 11,138 BA view · diff
git:20261006.61ffcb02026-10-06 61ffcb0 10,905 BA view · diff
git:20261004.8f59b862026-10-04 8f59b86 10,876 BA view · diff
git:20261001.fc8bd622026-10-01 fc8bd62 10,785 BA view · diff
git:20260927.2ff59962026-09-27 2ff5996 9,087 BA view · diff
git:20260927.f85642c2026-09-27 f85642c 8,908 BA view · diff
git:20260922.bbc32c62026-09-22 bbc32c6 8,940 BA view · diff
git:20260915.66e8d372026-09-15 66e8d37 8,584 BA view · diff
git:20260914.86932fe2026-09-14 86932fe 8,333 BA view · diff
git:20260912.bd2181b2026-09-12 bd2181b 8,118 BA view · diff
git:20260819.f80ced62026-08-19 f80ced6 7,990 BA view · diff
git:20260819.202ba092026-08-19 202ba09 8,052 BA view · diff
git:20260819.7af152e2026-08-19 7af152e 8,121 BA view · diff
git:20260813.cd92d422026-08-13 cd92d42 7,970 BA view · diff
git:20260727.a40bdb42026-07-27 a40bdb4 7,791 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 (11528 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_qc6vppj6xvms6k27
GET https://markdownregistry.com/api/v1/resolve?ref=tobihagemann/turbo/assess-technical-debt
GET https://markdownregistry.com/api/v1/blob/c22f5d35bc83f7e7b3533db7e327e665d44409ae0498ce2316a3211bde060037

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
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
commit-staged-push SKILL.md skill
tobihagemann/turbo · claude/skills/commit-staged-push/SKILL.md · Commit already-staged changes and push in one step. Use when the user asks to "commit and push staged changes", "commit…
git:20260508.4249183 · audit A · 417 stars

Every file in tobihagemann/turbo

Other files named assess-technical-debt

assess-technical-debt SKILL.md skill
tobihagemann/turbo · codex/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.