add-debt

Append a debt item to .planning/DEBT_LOG.md as a markdown table row.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/jasonmichaelbell78-creator/JASON-OS --skill add-debt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-debt
Source: https://github.com/jasonmichaelbell78-creator/JASON-OS/tree/main/.claude/skills/add-debt
Command: npx skills add https://github.com/jasonmichaelbell78-creator/JASON-OS --skill add-debt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables teams to quickly capture technical-debt items by appending a new row to the central debt log at .planning/DEBT_LOG.md, ensuring consistent documentation and traceability.

Core Features & Use Cases

  • Append a debt item to the debt log as a markdown table row.
  • Provide a lightweight mechanism for capturing cross-project debt when a full debt-tracking system is not yet available.
  • Support filing debt candidates during deep-research phase routing for later remediation.

Quick Start

Provide the debt title, severity, and category to append a new row to .planning/DEBT_LOG.md.

Frequently Asked Questions about add-debt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I log technical debt items to a markdown planning file?

You can log technical debt items by appending a new row to the .planning/DEBT_LOG.md markdown table, ensuring consistent documentation and traceability across your project workflow.

What is a lightweight way to track cross-project debt when a full system is unavailable?

A lightweight debt tracking entry involves appending a markdown table row with an incremented ID and date to a central log, providing traceability without needing a full debt-tracking system.

How do I capture debt candidates identified during deep-research phase routing?

During deep-research Phase 5, you can append reported debt candidates directly to your planning log as markdown table rows for later remediation and tracking.

What inputs do I need to append a new row to a debt log?

You need to provide the debt title, severity, and category to append a new row to the .planning/DEBT_LOG.md file, which automatically increments the D-id and adds the current date.

Will appending a new debt item overwrite my existing planning log entries?

Appending a new debt item does not overwrite existing entries; it updates the log by adding a new markdown table row with an incremented D-id while preserving all previous records.