New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Shortcut Debt Tracker

Ponytail debt

by DietrichGebert · MIT license · ★ 153,538 on GitHub

Ponytail debt cover

Harvest every ponytail: shortcut comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.

---
name: ponytail-debt
description: "Harvest every ponytail: shortcut comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report."
homepage: https://github.com/DietrichGebert/ponytail
license: MIT
---

Every deliberate ponytail shortcut is marked with a `ponytail:` comment naming
its ceiling and upgrade path. This collects them into one ledger so a deferral
can't quietly become permanent.

## Scan

Grep the repo for comment markers, skipping `node_modules`, `.git`, and build
output:

`grep -rnE --exclude-dir=.git --exclude-dir=node_modules --exclude-dir=dist --exclude-dir=build '(#|//|/[*]) ?ponytail:' .`  (add other comment prefixes if your stack uses them)

Overview

Every deliberate ponytail shortcut is marked with a ponytail: comment naming its ceiling and upgrade path. This collects them into one ledger so a deferral can't quietly become permanent.

Manual install (npx, ZIP)
Claude Codenpx skills add DietrichGebert/ponytail --skill ponytail-debt -g -a claude-code
Claude Code (degit)npx degit DietrichGebert/ponytail/.openclaw/skills/ponytail-debt#main ~/.claude/skills/ponytail-debt
Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md1.6 KB
Read SKILL.md here
DietrichGebert/main1 file shown
SKILL.md
Show the full text42 lines
ponytail-debt/SKILL.md42 lines · 1.6 KB

Every deliberate ponytail shortcut is marked with a ponytail: comment naming its ceiling and upgrade path. This collects them into one ledger so a deferral can't quietly become permanent.

Scan

Grep the repo for comment markers, skipping node_modules, .git, and build output:

grep -rnE --exclude-dir=.git --exclude-dir=node_modules --exclude-dir=dist --exclude-dir=build '(#|//|/[*]) ?ponytail:' . (add other comment prefixes if your stack uses them)

Each hit is one ledger row. The comment prefix keeps prose that merely mentions the convention out of the ledger.

Output

One row per marker, grouped by file:

<file>:<line>, <what was simplified>. ceiling: <the limit named>. upgrade: <the trigger to revisit>.

The convention is ponytail: <ceiling>, <upgrade path>, so pull the ceiling and the trigger straight from the comment. Want an owner per row too? add git blame -L<line>,<line>.

Flag the rot risk: any ponytail: comment that names no upgrade path or trigger gets a no-trigger tag, those are the ones that silently rot.

End with <N> markers, <M> with no trigger. Nothing found: No ponytail: debt. Clean ledger.

Boundaries

Reads and reports only, changes nothing. To persist it, ask and it writes the ledger to a file (e.g. PONYTAIL-DEBT.md). One-shot. "stop ponytail-debt" or "normal mode" to revert.

1---
2name: ponytail-debt
3description: "Harvest every ponytail: shortcut comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report."
4homepage: https://github.com/DietrichGebert/ponytail
5license: MIT
6---
7 
8Every deliberate ponytail shortcut is marked with a `ponytail:` comment naming
9its ceiling and upgrade path. This collects them into one ledger so a deferral
10can't quietly become permanent.
11 
12## Scan
13 
14Grep the repo for comment markers, skipping `node_modules`, `.git`, and build
15output:
16 
17`grep -rnE --exclude-dir=.git --exclude-dir=node_modules --exclude-dir=dist --exclude-dir=build '(#|//|/[*]) ?ponytail:' .` (add other comment prefixes if your stack uses them)
18 
19Each hit is one ledger row. The comment prefix keeps prose that merely mentions
20the convention out of the ledger.
21 
22## Output
23 
24One row per marker, grouped by file:
25 
26`<file>:<line>, <what was simplified>. ceiling: <the limit named>. upgrade: <the trigger to revisit>.`
27 
28The convention is `ponytail: <ceiling>, <upgrade path>`, so pull the ceiling
29and the trigger straight from the comment. Want an owner per row too? add
30`git blame -L<line>,<line>`.
31 
32Flag the rot risk: any `ponytail:` comment that names no upgrade path or
33trigger gets a `no-trigger` tag, those are the ones that silently rot.
34 
35End with `<N> markers, <M> with no trigger.` Nothing found: `No ponytail: debt. Clean ledger.`
36 
37## Boundaries
38 
39Reads and reports only, changes nothing. To persist it, ask and it writes the
40ledger to a file (e.g. `PONYTAIL-DEBT.md`). One-shot. "stop ponytail-debt" or
41"normal mode" to revert.
42 
View all files on GitHub →

Details

License
MIT
Stars on the repo
★ 153,538
Checked
Source
DietrichGebert/ponytail ↗
Creator
DietrichGebert · 6 listings
View creator

Similar skills

See all →

More from DietrichGebert

Repository Over-Engineering AuditorDietrichGebert/ponytail · by DietrichGebertWhole-repo audit for over-engineering. Like ponytail-review, but scans the entire codebase instead of a diff: a ranked list of what to delete, simplify, or replace with stdlib/native equivalents. Use when the user says "audit this codebase", "audit for over-engineering", "what can I delete from this repo", find bloat", "ponytail-audit", or "/ponytail-audit". One-shot report, does not apply fixes.★ 154k GitHub starsCodebase Simplification AuditDietrichGebert/ponytail · by DietrichGebertAudit the whole repo for over-engineering. A ranked list of what to delete, simplify, or replace with stdlib or native features.★ 154k GitHub starsTechnical Debt Ledger GeneratorDietrichGebert/ponytail · by DietrichGebertHarvest every `ponytail:` comment in the codebase into a debt ledger, so the deliberate shortcuts and deferrals ponytail leaves behind get tracked instead of rotting into "later means never". Use when the user says "ponytail debt", /ponytail-debt", "what did ponytail defer", "list the shortcuts", "ponytail ledger", or "what did we mark to do later". One-shot report, changes nothing.★ 154k GitHub starsPonytail Reference GuideDietrichGebert/ponytail · by DietrichGebertQuick reference for ponytail's modes, skills, and commands. One-shot display.★ 154k GitHub starsDiff Over-Engineering ReviewerDietrichGebert/ponytail · by DietrichGebertReview a diff for over-engineering. Finds what to delete: reinvented stdlib, needless deps, speculative abstractions. One line per finding.★ 154k GitHub stars