本文へ移動
cccskills
無料GitHub で公開

absolute-debt

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".

インストール方法を見る

含まれるファイル(3)

  • SKILL.md4.2 KB
  • README.md729 B
  • references/health-engine.md5.3 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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

EcosystemLint debtType debt
JS/TSeslint . (full report, by rule)tsc --noEmit
Pythonruff check / flake8mypy / pyright
Gogolangci-lint rungo 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)

WaveClassDefault
1autofixable lint (eslint --fix, ruff --fix, gofmt)fix now — mechanical, safe
2manual lint by rule, low behavioral risk (unused, style, imports)fix this pass, one rule at a time
3type errors, and lint rules that can change behavior if "fixed" wronggated — review each, may need real logic
4removing 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.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Vulnerability and security scan (defensive, your own repo): dependency CVEs plus risky code patterns (secrets, injection, weak authz), severity x reachability triaged and remediated without suppressing. Complements the built-in /security-review. Triggers on "absolute audit", "security audit", "are we vulnerable", "scan for CVEs", "check for secrets/injection", "harden this".

日本語の概要は準備中です。原文の説明を表示しています。

maddhruv/absolute2192026年7月6日 更新

Flaky test fixes: detect nondeterministic tests empirically (repeat/shuffle/parallel runs), diagnose the root cause, fix it — never retry/skip/sleep — and verify across many randomized runs. Triggers on "absolute deflake", "fix flaky tests", "CI is flaky", "this test fails randomly/intermittently".

日本語の概要は準備中です。原文の説明を表示しています。

maddhruv/absolute2192026年7月6日 更新

Diátaxis-driven documentation for AI coding agents: write, improve, or audit tutorials, how-tos, reference, explanation, and developer docs (README, CONTRIBUTING, ADRs). Detects the docs stack; gates on the outline before writing prose; verifies every claim against the code before it ships. Triggers on "absolute docs", "write docs", "write a tutorial", "write a README", "document this", "improve this doc", "audit our docs".

日本語の概要は準備中です。原文の説明を表示しています。

maddhruv/absolute2192026年7月6日 更新

One-time setup for absolute: interview how you want it to behave (output style, autonomy, TDD strictness, spec dir, families) + detect the stack once, then write `.absolute.config.json` (project, committed) and `~/.absolute/config.json` (user defaults + per-project overrides). Every other absolute-* command reads it instead of re-detecting; non-blocking — commands proceed without it and soft-recommend it. Triggers on "absolute init", "set up absolute", "initialize absolute", "configure absolute", "first-time setup", "remember my conventions for this repo".

日本語の概要は準備中です。原文の説明を表示しています。

maddhruv/absolute2192026年7月6日 更新

Dead code and dependency cleanup, repo-wide: unused deps, unreferenced exports, unreachable code, orphaned files — removed only with tool evidence, in reversible waves. Runs on green main. For diff-scoped cleanup use absolute-simplify. Triggers on "absolute prune", "remove dead code", "find unused deps/exports", "what can we delete", "clean up orphaned files".

日本語の概要は準備中です。原文の説明を表示しています。

maddhruv/absolute2192026年7月6日 更新

Use when the user wants to simplify, clean up, refactor, tidy, or refine code — their staged/unstaged git changes or a target file/path. Reduces complexity, flattens nesting, removes redundancy and dead code, scores each change by value (holding low-value churn), then runs tests to prove nothing broke. Invoke on: "simplify", "simplify this", "simplify my code/changes", "clean up", "clean this up", "clean up my changes", "refactor this", "make this cleaner", "tidy this up", "reduce complexity", "flatten this", "remove dead code", "make it more readable", "polish before commit", or "absolute simplify". Acts on your working diff; for repo-wide dead code use absolute-prune; for lint/type debt use absolute-debt.

日本語の概要は準備中です。原文の説明を表示しています。

maddhruv/absolute2192026年7月6日 更新

maddhruv のスキルをすべて見る

このスキルの問題を報告する