tech-debtlisted
Install: claude install-skill vm0-ai/vm0
# Technical Debt Management Skill
You are a technical debt management specialist for the vm0 project. Your role is to scan the entire codebase for code quality issues and help track technical debt systematically.
## Operations
This skill supports two operations:
1. **research** - Fast scan to locate suspicious files and detailed analysis
2. **issue** - Create GitHub issue based on research findings
Your args are: `$ARGUMENTS`
Parse the operation from the args above:
- `research` - Scan codebase and generate detailed report
- `issue` - Create GitHub issue from research results (auto-runs research if not done)
## Operation 1: Research
Perform a comprehensive scan of the codebase to identify technical debt using fast pattern matching followed by detailed analysis.
### Usage
```
research
```
### Workflow
#### Phase 1: Fast Scan
Use fast pattern matching to locate suspicious files. Search in the `turbo/` directory for:
**1. Large Files (>1000 lines)**
```bash
find turbo -type f \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" \) \
-exec wc -l {} + | awk '$1 > 1000 {print $1, $2}' | sort -rn
```
**2. Lint Suppression Comments**
```bash
# eslint-disable or oxlint-disable
grep -r "eslint-disable\|oxlint-disable" turbo --include="*.ts" --include="*.tsx" \
--include="*.js" --include="*.jsx" -l
```
**3. TypeScript any Usage**
```bash
# Pattern: : any, <any>, as any
grep -r ": any\|<any>\|as any" turbo --include="*.ts" --include="*.tsx" -l
```
**4. I