Agent skill · Security

technical-debt-detector

Identify and prioritize technical debt in Python codebases. Use when the user asks to find tech debt, analyze code quality, identify what needs refactoring, find security issues, check test coverage gaps, review dependencies, find TODOs/FIXMEs, or assess maintainability. Triggers on phrases like "find technical debt", "what's wrong with this codebase", "where should I focus refactoring", "audit this code", "find TODOs", "check for security issues", "analyze dependencies", or "what needs tests". Complements python-simplifier skill (use that for complexity and code smell analysis).

majiayu000github.com/majiayu000GitHub ↗
claude-codeMIT
Install
npx skills add majiayu000/claude-skill-registry --skill technical-debt-detector-charlesmsiegel-tg-a42e628c --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 2
SKILL.md size: 4 KB
Bundled scripts: none
Path: skills/analysis/technical-debt-detector-charlesmsiegel-tg-a42e628c/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 534
Language: HTML

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Technical Debt Detector Efficiently identify technical debt in large Python projects using scripts that output targeted file locations, minimizing token cost. ## Quick Start ```bash # Full analysis - produces prioritized report python scripts/analyze_all.py /path/to/project # JSON output for programmatic use python scripts/analyze_all.py /path/to/project --format json # Run specific checks only python scripts/analyze_all.py /path/to/project --only security testing ``` ## Individual Analyzers Run specific checks when focused analysis is needed: | Script | Purpose | Key Outputs | |--------|---------|-------------| | `analyze_all.py` | Master analyzer - runs all checks | Prioritized report with fix sketches | | `find_deferred_work.py` | TODO/FIXME/HACK/XXX markers | Location + message + severity | | `find_security_issues.py` | Security vulnerabilities (uses bandit) | CVEs, hardcoded secrets, unsafe patterns | | `analyze_test_coverage.py` | Missing tests, coverage gaps | Untested modules, empty tests | | `find_maintainability_issues.py` | Docstrings, type hints, naming | Missing docs, bad names, long functions | | `check_dependencies.py` | Outdated packages, vulnerabilities | Version

What's inside
Steps it walks through
  1. Quick Start
  2. Individual Analyzers
  3. Usage Examples
  4. Workflow
  5. Output Format
  6. Dependencies
  7. Severity Levels
  8. Relationship to python-simplifier
Ships with 1 file
  • metadata.json
Commands it runs
Full analysis - produces prioritized report
python scripts/analyze_all.py /path/to/project
JSON output for programmatic use
python scripts/analyze_all.py /path/to/project --format json
Run specific checks only
python scripts/analyze_all.py /path/to/project --only security testing
Find all deferred work
python scripts/find_deferred_work.py /path/to/project
python scripts/find_deferred_work.py . --severity high  # Only FIXME/BUG/HACK/XXX
Security scan
More from claude-skill-registry
All skills →
About this skill
What does the technical-debt-detector skill do?

Identify and prioritize technical debt in Python codebases. Use when the user asks to find tech debt, analyze code quality, identify what needs refactoring, find security issues, check test coverage gaps, review dependencies, find TODOs/FIXMEs, or assess maintainability. Triggers on phrases like "find technical debt", "what's wrong with this codebase", "where should I focus refactoring", "audit this code", "find TODOs", "check for security issues", "analyze dependencies", or "what needs tests". Complements python-simplifier skill (use that for complexity and code smell analysis).

How do I install it?

Run `npx skills add majiayu000/claude-skill-registry --skill technical-debt-detector-charlesmsiegel-tg-a42e628c --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going