Harvest Debt

Collect SHORTCUT: markers across the codebase into a tech-debt ledger at docs/debt.md. Use when asked to harvest debt, audit technical shortcuts, or inventory deferred simplifications.

43 stars 9 forksWriting & ContentOfficial

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add aws-samples/sample-kiro-cli-multiagent-development --skill harvest-debt
Manual install
git clone --depth 1 https://github.com/aws-samples/sample-kiro-cli-multiagent-development.git /tmp/sample-kiro-cli-multiagent-development
mkdir -p ~/.claude/skills
cp -r /tmp/sample-kiro-cli-multiagent-development/skills/harvest-debt ~/.claude/skills/harvest-debt

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Harvest Debt

Collect the intentional `SHORTCUT:` markers scattered through the codebase into a single debt ledger, so deferred simplifications stay visible instead of becoming permanent.

## Process

1. **Find the markers.** Search the repo for `SHORTCUT:` comments (skip `.git`, build output, vendored deps, and `node_modules`):
   ```bash
   grep -rn "SHORTCUT:" . \
     --include='*.py' --include='*.ts' --include='*.tsx' --include='*.js' \
     --include='*.go' --include='*.rs' --include='*.java' --include='*.rb' \
     --include='*.sh' --include='*.tf' --include='*.yaml' --include='*.yml' \
     2>/dev/null | grep -v node_modules
   ```
   Adjust the extensions to the project's languages. If the project has none, say so and stop.

2. **Parse each marker** into: file:line, the ceiling (the named limitation), and the upgrade path. A marker that names no ceiling is itself a finding — flag it as "unspecified ceiling — needs a real limit named or removal."

3. **Write the ledger** to `docs/debt.md` (create it if missing). Group by area/module. Use this shape:

   ```markdown
   # Tech Debt Ledger

   _Generated from `SHORTCUT:` markers on <date>. Each entry is an intentional simplification with a known ceiling._

   | Location | Shortcut | Ceiling (when it breaks) | Upgrade path |
   |----------|----------|--------------------------|--------------|
   | `db.py:42` | global lock | throughput-bound past ~N writes/s | per-account locks |
   ```
Read the full skill on GitHub

Details

Skill name
harvest-debt
Path
skills/harvest-debt/SKILL.md
License
MIT-0
Repo updated
9 September 2026

FAQ

What does the Harvest Debt skill do?

Collect SHORTCUT: markers across the codebase into a tech-debt ledger at docs/debt.md. Use when asked to harvest debt, audit technical shortcuts, or inventory deferred simplifications.

How do I install the Harvest Debt skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add aws-samples/sample-kiro-cli-multiagent-development --skill harvest-debt. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Harvest Debt popular?

It lives in aws-samples/sample-kiro-cli-multiagent-development, which has 43 GitHub stars and 9 forks.

Related skills

Agentcore Patterns

43

aws-samples/sample-kiro-cli-multiagent-development

Verified Amazon Bedrock AgentCore patterns for Runtime handlers, Gateway MCP clients with SigV4/IAM auth, Memory session management with Strands, and Bedrock cross-region inference-profile IAM policies. Use when building or debugging AgentCore-based agents.

AI, LLMs & Agents

AWS Technical Docs

43

aws-samples/sample-kiro-cli-multiagent-development

AWS technical documentation patterns covering procedures, lists, tables, titles, error messages, and content patterns. Use when writing AWS service documentation, procedures, troubleshooting guides, tutorials, or getting started content.

Writing & Content

CLI Execution

43

aws-samples/sample-kiro-cli-multiagent-development

CLI execution best practices covering RTK token compression, AWS discover-then-execute patterns, output control, and bash/zsh scripting with logging. Use when running CLI commands, querying AWS resources, writing automation scripts, or working with shell tooling.

Software Development

Principle Attack the Premise

107

Dimon94/skills

Apply when two or more fixes that share one premise have failed the same gate. Write the premise down and test it directly before you write another fix that assumes it.

Writing & Content21

Documentation

43

aws-samples/sample-kiro-cli-multiagent-development

Technical documentation patterns including READMEs, API docs, runbooks, and architecture decision records. Use when writing documentation, creating runbooks, or documenting system architecture.

Writing & Content

Writing Tidyverse R

67

jeremy-allen/claude-skills

Modern tidyverse patterns, style guide, and migration guidance for R development. Use this skill when writing R code with dplyr, reviewing tidyverse code, updating legacy R code to modern patterns, or enforcing consistent style. Covers native pipe usage, join_by() syntax, .by grouping, pick/across/reframe operations, tidy selection, stringr patterns, naming conventions, spacing, and migration from base R or older tidyverse APIs.

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.