К основному содержанию
скилл CX Codex

absolute-debt — скилл для Claude Code: что делает и как установить

Скилл absolute-debt для Claude Code устраняет накопленные ошибки линтеров и проверки типов по всему репозиторию. Очистка запускается волнами на зелёной ветке main.

MIT 162 установок ★ 224 обновлён 2026-10-26

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add dhruvjainin/absolute --skill absolute-debt -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/absolute-debt/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/absolute-debt/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
debt-management JoelLewis Скилл debt-management для Claude Code, который разбирает стратегии погашения долгов. Считает лавину и снежный ком, рефинансирование, DTI и альтернативную стоимость досрочных платежей. CX Codex +1 822установок debt-payoff openaccountant Скилл debt-payoff для Claude Code и ещё пяти агентных сред, который строит план погашения долгов методами avalanche и snowball. Считает свободные деньги из бюджета и раскладывает платежи по месяцам. CX Codex +1 495установок sec-debt-covenant OctagonAI Скилл sec-debt-covenant для Claude Code разбирает долговые ковенанты и условия кредитных соглашений в SEC-файлингах. Проверяет лимиты, сроки погашения и соблюдение обязательств. CX Codex +1 257установок technical-debt-manager davila7 Субагент technical-debt-manager находит архитектурные проблемы и дыры в тестах. Помогает составить план рефакторинга перед спринтом. CX Codex 857установок code-review vectorize-io Скилл code-review проверяет изменённый код по стандартам проекта: ищет пропущенные тесты, мёртвый код, проблемы типов и линтинга. Запускайте его после реализации. CX Codex +1 178установок dead-code-detector terrylica Скилл dead-code-detector ищет неиспользуемые функции, импорты и файлы в проектах на Python, TypeScript и Rust. Помогает подготовить кодовую базу к релизу и почистить зависимости. CX Codex +1 150установок

Из того же набора11

Весь набор →
absolute-simplify Скилл absolute-simplify для Claude Code и Cursor, который упрощает код, снижает вложенность и удаляет мёртвый код. Запускается автономно на изменённых файлах или выбранном пути. CX Codex +1 336установок absolute-work Скилл absolute-work для Claude Code и Codex ведёт разработку через фазовые переходы от интервью по архитектуре до проверенного тестами кода. Включается при запросах на полный цикл создания фичи или миграцию. CX Codex +1 216установок absolute-spec Скилл absolute-spec для Claude Code превращает запрос на функцию в проектную спецификацию после изучения кодовой базы. Агент задаёт несколько уточняющих вопросов, записывает документ в docs/plans/ и передаёт его на отдельную оценку. CX Codex +1 176установок absolute-docs Скилл absolute-docs для Claude Code структурирует техническую документацию по методологии Diátaxis. Помогает писать руководства, справочники, README и проводить аудит существующих страниц. CX Codex +1 171установок absolute-prune Скилл absolute-prune для Claude Code очищает репозиторий от мёртвого кода и неиспользуемых зависимостей. Запускается на чистой ветке main по подтверждённым данным статических анализаторов. CX Codex +1 170установок absolute-deflake Скилл absolute-deflake для Claude Code находит тесты, которые то проходят, то падают, и исправляет источник нестабильности. Запускается по запросам о случайных сбоях тестов и проблемах с flaky CI. CX Codex +1 165установок absolute-init Скилл absolute-init для Claude Code настраивает absolute под проект и предпочтения разработчика. Запускается по запросу «настрой absolute» или при первом использовании absolute в репозитории. CX Codex +1 160установок absolute-upgrade Скилл absolute-upgrade для Claude Code обновляет устаревшие и уязвимые зависимости по группам риска. Запускается на зелёной основной ветке или по просьбе обновить пакеты. CX Codex +1 155установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой