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.
Install
npx skills add aws-samples/sample-kiro-cli-multiagent-development --skill harvest-debtgit 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-debtPersonal 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 |
```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
43aws-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.
AWS Technical Docs
43aws-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.
CLI Execution
43aws-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.
Principle Attack the Premise
107Dimon94/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.
Documentation
43aws-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 Tidyverse R
67jeremy-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.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.