Skills
.Work. You
Rest

debt-ledger

Community

Advisory debt ledger for codebases.

Software Engineering#scanning#markers#ledger#debt#code-debt#deliberate-simplification
Authorpaulingham
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Advisory and automated tool to identify and surface deliberate-simplification debt markers (DEBT:) across a codebase, render a per-file ledger, and flag entries with no upgrade trigger (silent rot). It remains advisory, never gating progress.

Core Features & Use Cases

  • Gathers all DEBT: markers across the repository and collects them into a grouped ledger.
  • Renders a per-file ledger, highlighting whether each marker has an upgrade trigger or is no-trigger.
  • Excludes noise like vendor and build directories to keep focus on actionable debt.
  • Use Case: During Reflect to track debt trends and surface silent rot, or in periodic sweeps to keep the codebase debt visible.

Quick Start

Scan the repository for DEBT markers and render a per-file ledger for review.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: debt-ledger
Download link: https://github.com/paulingham/.claude/archive/main.zip#debt-ledger

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 545,000+ vetted skills library on demand.