Not in the top 1,000 by GitHub stars
ksimback/tech-debt-skill
Claude Code skill that produces a thorough, file-cited tech debt audit of an entire codebase
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
SKILL.md
Week of Nov 2, 2026 · +0 / −0 lines
Before Network or broad shell → After Network or broad shell
5a15c1ca4a92 → 5a15c1ca4a92
Diff text is unavailable under the recorded licenses. Line counts and the GitHub link remain available.
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → 5a15c1ca4a92
No earlier version was observed for comparison.
Heat
0.3- Star growth, last 7 daysNot available
- Star growth, last 24 hoursNot available
- Rank movement, last 7 daysNot available
- Commits, last 30 daysNot available
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekNot available
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
Individual skills in this repository
How it works
tech-debt-audit
When your agent uses it
Thorough, user-invoked tech debt and architecture audit of the current codebase. Produces TECH_DEBT_AUDIT.md with file-cited findings, severity, effort estimates, and a required "looks bad but is actually fine" section. Use when the user asks for a debt audit, codebase health check, architecture review, or code quality assessment of an entire repo. Does not auto-invoke.
What it loads into context
Frontmatter
100 tokensAlways available to the agent
SKILL.md
2,952 tokensWhen the skill is activated
Reference documents
2,086 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- Operating principles
- Phase 1: Orient
- Phase 2: Audit across these dimensions
- Phase 3: Deliverable
- Rules
- Stack-specific tooling
- Large repos: spawn subagents
- Repeat-run mode
- Installation
- Usage
- Philosophy
- What you get
- Adaptation notes
- Limitations
- Contributing
- License
- Credits
Files
.gitignoreasset9 bytesREADME.mddoc9,109 bytesSKILL.mdcore12,880 bytesSKILL.mdcore12,880 bytesSKILL.mdcore12,880 bytesSKILL.mdcore12,880 bytesSKILL.mdcore12,880 bytes
No excerpt is shown for this license. Read the source on GitHub.
View the complete source on GitHubSkills included
- tech-debt-audit
Repository facts
- License
- No license detected
- Created
- Apr 25, 2026
- Last pushed
- Apr 25, 2026
- Forks
- 38
- Open issues
- 0
- Project activity
- Slowing
Rank over the last 12 weeks
Now #951 · best #767 · down 80 in 30 days
- #952 on Oct 8
- #916 on Oct 9
- #899 on Oct 11
- #947 on Oct 16
- #912 on Oct 18
- #951 since Oct 22
31 earlier periods
- #771 on Aug 2
- #782 on Aug 7
- #830 on Aug 11
- #826 on Aug 12
- #823 on Aug 13
- #808 on Aug 14
- #779 on Aug 15
- #800 on Aug 16
- #827 on Aug 18
- #819 on Aug 19
- #815 on Aug 21
- #767 on Aug 22
- #822 on Aug 23
- #846 on Aug 25
- #833 on Aug 26
- #878 on Sep 1
- #864 on Sep 7
- #885 on Sep 8
- #837 on Sep 13
- #857 on Sep 18
- #832 on Sep 19
- #851 on Sep 20
- #871 on Sep 21
- #883 on Sep 23
- #846 on Sep 24
- #823 on Sep 26
- #892 on Sep 28
- #925 on Sep 29
- #824 on Oct 3
- #883 on Oct 5
- #870 on Oct 6
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 6, 2026
Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.
Show 4 notes
SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedSKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedSKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedSKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzed
- No broad tool permissions
- No dangerous shell commands
- 4 network referencesin 2 files: README.md:53 SKILL.md:112
- No hidden or obfuscated text
- No instruction overrides
- No executable scripts
- No access to secrets
- No requests to vote in Hot
Show all 4 signals by file
README.md
- Network accessline 53
curl -o ~/.claude/skills/tech-debt-audit/SKILL.md https://raw.githubusercontent.com/ksimback/tech-debt-skill/main/SKILL.md - Network accessline 59
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 - Network accessline 166
Built on the [Claude Code Agent Skills](https://code.claude.com/docs/en/skills) standard.
SKILL.md
- Network accessline 112
curl -o ~/.claude/skills/tech-debt-audit/SKILL.md https://raw.githubusercontent.com/ksimback/tech-debt-skill/main/SKILL.md
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Signal confidence: 4 facts
- Network access in code of documentationREADME.md:53Low confidence
- Network access in code of documentationREADME.md:59Low confidence
- Network access in prose of documentationREADME.md:166Low confidence
- Network access in code of the SKILL.mdSKILL.md:112High confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Native | Frontmatter field disable-model-invocation in SKILL.md | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.
