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).
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.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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
- Quick Start
- Individual Analyzers
- Usage Examples
- Workflow
- Output Format
- Dependencies
- Severity Levels
- Relationship to python-simplifier
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
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.
