This skill runs a deliberate, citation-backed audit of a codebase and produces a structured report of findings sorted by impact. It helps engineering managers, technical leads, and senior engineers find the debt that actually matters — and avoid chasing patterns that only look wrong. Every finding cites a file and line, and the report includes a required section for cases where the code looks bad but is intentionally built that way.
Follow the documented setup, then try a first task.
Installs: Installs the tech-debt-audit skill for use across all projects. · Claude Code
In a terminal, create the personal Claude Code skill directory.
mkdir -p ~/.claude/skills/tech-debt-audit
In the terminal, download the skill document into that directory.
curl -o ~/.claude/skills/tech-debt-audit/SKILL.md https://raw.githubusercontent.com/ksimback/tech-debt-skill/main/SKILL.md
In the terminal, verify that Claude Code reports the skill as available.
claude --print "/skills" | grep tech-debt-audit
Installs: Installs the tech-debt-audit skill only for the current repository. · Claude Code
Run from: The root of the repository where the skill should be available
In a terminal opened at the repository root, create the project skill directory and download the skill document.
mkdir -p .claude/skills/tech-debt-audit && curl -o .claude/skills/tech-debt-audit/SKILL.md https://raw.githubusercontent.com/ksimback/tech-debt-skill/main/SKILL.md
In the terminal, verify that Claude Code reports the skill as available.
claude --print "/skills" | grep tech-debt-audit
Installs: Copies a local SKILL.md into the current repository as the tech-debt-audit skill. · Claude Code
Run from: The root of the repository where the skill should be available
In a terminal opened at the target repository root, replace /path/to/SKILL.md with the path to the local copy of this repository's SKILL.md, while keeping the documented destination unchanged.
mkdir -p .claude/skills/tech-debt-audit && cp /path/to/SKILL.md .claude/skills/tech-debt-audit/SKILL.md
In the terminal, verify that Claude Code loaded the skill.
echo "/skills" | claude
Uses tech-debt-audit
/tech-debt-audit src/payments
Claude