absolute-debt — скилл для Claude Code: что делает и как установить
Скилл absolute-debt для Claude Code устраняет накопленные ошибки линтеров и проверки типов по всему репозиторию. Очистка запускается волнами на зелёной ветке main.
MIT 162 установок ★ 224 обновлён 2026-10-26
npx skills add dhruvjainin/absolute --skill absolute-debt -a claude-codeЧто делает absolute-debt
Скилл находит застарелые предупреждения линтера, сбои типизации и заглушки вроде @ts-ignore или # type: ignore. Правки вносятся строго по одному правилу на весь проект, чтобы изменения оставались понятными при проверке диффа. Инструмент поддерживает экосистемы JavaScript и TypeScript через eslint и tsc, Python через ruff, flake8, mypy и pyright, а также Go через golangci-lint и staticcheck.
Процесс разбит на четыре волны риска: от автоматических правок форматерами до ручного разбора подавлений ошибок. После каждого этапа прогоняются тесты, линтер и сборка. Закрывать проблему новыми заглушками или приведением к any запрещено правилами скилла — исправлять требуется саму причину бага.
Инструмент рассчитан только на чистый статус основной ветки. Для проверки рабочего диффа текущей задачи автор рекомендует отдельную команду absolute-simplify.
Какие задачи решает
- устранить старые предупреждения ESLint и Ruff по всему репозиторию
- избавиться от директив @ts-ignore и # type: ignore без потери стабильности
- подготовить кодовую базу к строгому режиму компилятора TypeScript
- разобрать системные ошибки типизации без добавления типов any
Примеры запросов агенту
- Погаси накопившиеся ошибки линтера и типов по всему проекту
- Убери старые директивы @ts-ignore и исправь причины сбоев
- Переведи кодовую базу на строгий режим проверки типов
Как установить absolute-debt
1Через Skills CLI (Vercel)
npx skills add dhruvjainin/absolute --skill absolute-debt -a claude-code2Вручную: положить файлы
~/.claude/skills/absolute-debt/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/absolute-debt/
1Через Skills CLI (Vercel)
npx skills add dhruvjainin/absolute --skill absolute-debt -a codex2Вручную: положить файлы
.agents/skills/absolute-debt/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dhruvjainin/absolute --skill absolute-debt -a cursor2Вручную: положить файлы
.cursor/skills/absolute-debt/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dhruvjainin/absolute skills/absolute-debt2Вручную: положить файлы
.github/skills/absolute-debt/SKILL.md1Через Skills CLI (Vercel)
npx skills add dhruvjainin/absolute --skill absolute-debt -a gemini-cli2Командой платформы
gemini skills install https://github.com/dhruvjainin/absolute --path skills/absolute-debtВручную: положить файлы
.devin/skills/absolute-debt/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add dhruvjainin/absolute --skill absolute-debt -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об absolute-debt
Как установить absolute-debt в Claude Code?
Выполните команду npx skills add dhruvjainin/absolute --skill absolute-debt -a claude-code в терминале.
Что делает absolute-debt?
Скилл сканирует проект на старые предупреждения линтеров и сбои типов, группирует их по правилам и волнами исправляет коренные причины ошибок.
Чем absolute-debt отличается от absolute-simplify?
Команда simplify полирует локальный дифф текущей ветки, а debt планомерно вычищает старый технический долг на стабильной ветке main.
Исходный текст
SKILL.md · MIT
--- name: absolute-debt version: 0.5.0 description: > Lint and typecheck debt paydown: clear pre-existing repo-wide lint/type violations and suppressions (@ts-ignore, # type: ignore) one rule per wave, fixing causes not symptoms. Runs on green main. For diff-scoped quality use absolute-simplify. Triggers on "absolute debt", "fix our lint warnings", "clear the type errors", "get to strict mode", "burn down suppressions". category: workflow tags: - workflow - maintenance - linting - typescript - debt platforms: - claude-code - gemini-cli - openai-codex - mcp user-invocable: true argument-hint: "[target]" license: MIT maintainers: - github: maddhruv --- > Start your first response with the 🧾 emoji. ## Absolute Debt Pay down accumulated lint and type-checker debt across the repo — existing warnings, errors, and suppressions that built up over time — in safe waves, by rule, with tests green after each. The goal is a genuinely clean `lint` + `typecheck`, not a quieter one. Runs the shared engine in **`references/health-engine.md`** — read it for the DETECT → SCAN → TRIAGE → FIX → VERIFY → REPORT loop and the safety contract. This file covers only what's specific to lint/type debt. --- ## When to use - "Fix our lint warnings", "clean up the type errors", "get the codebase to strict mode". - Tightening config (enable a rule, raise `tsconfig` strictness) and clearing the fallout. - Burning down accumulated `eslint-disable` / `@ts-ignore` / `# type: ignore` suppressions. **`debt` vs `simplify`:** `simplify` improves *your working diff's* quality. `debt` clears **pre-existing repo-wide** lint/type violations on green `main`. Use `debt` for standing cleanup, not for changes you're actively making. --- ## What it scans | Ecosystem | Lint debt | Type debt | |---|---|---| | JS/TS | `eslint .` (full report, by rule) | `tsc --noEmit` | | Python | `ruff check` / `flake8` | `mypy` / `pyright` | | Go | `golangci-lint run` | `go vet ./...`, `staticcheck` | Also inventory **suppressions** as debt in their own right: `eslint-disable*`, `@ts-ignore`/`@ts-expect-error`, `# type: ignore`, `# noqa`, `//nolint`. Each is a hidden violation. Count violations grouped **by rule** (not by file) — that's how you wave them. --- ## Risk ranking (TRIAGE) | Wave | Class | Default | |---|---|---| | 1 | autofixable lint (`eslint --fix`, `ruff --fix`, `gofmt`) | fix now — mechanical, safe | | 2 | manual lint by rule, low behavioral risk (unused, style, imports) | fix this pass, one rule at a time | | 3 | type errors, and lint rules that can change behavior if "fixed" wrong | gated — review each, may need real logic | | 4 | removing suppressions (`@ts-ignore` etc.) | gated — each may surface a real bug | Fix **one rule across the repo per wave**, not one file across all rules — keeps diffs reviewable and regressions bisectable. Config tightening (enable rule / raise strictness) is itself a finding: propose it, then clear what it surfaces. --- ## Fix & verify - Run the autofixers first (wave 1), commit-ready, then re-scan to see what's truly manual. - Manual fixes: address the *cause*, not the symptom. A type error means the types are wrong somewhere — fix the type, don't cast to `any`/add `# type: ignore`. - **Never** clear a violation by suppressing it. Removing suppressions is the *goal*, not a tool. - After each wave: full test + lint + typecheck + build. The violation count must drop and nothing regress. --- ## Gotchas 1. **Fixing by suppressing.** `@ts-ignore` to clear a type error *adds* debt. Forbidden here. 2. **`any` / `cast` to win.** Silences the checker, keeps the bug. Fix the real type. 3. **One-file-all-rules waves.** Mixes concerns, unreviewable. Go one-rule-all-files. 4. **Autofix without review.** `--fix` can change behavior (e.g. `prefer-const` on a reassigned var via a bug). Run tests after autofix too. 5. **Disabling the rule instead of fixing.** Loosening config to hit zero is debt laundering, not paydown. --- ## Companion commands - **`/absolute simplify`** — quality of code you're *currently changing*. - **`/absolute prune`** — many unused-var/import warnings vanish once dead code is pruned. - **`/absolute work`** — if clearing the debt needs real refactoring, hand off.
© dhruvjainin · MIT · dhruvjainin/absolute