Files
wehub-resource-sync 4537a26bc6
skill-evals / security scan (push) Failing after 0s
skill-evals / skill lint (strict) (push) Failing after 0s
skill-evals / trigger & routing (push) Failing after 1s
skill-evals / deterministic evals (push) Failing after 3s
chore: import upstream snapshot with attribution
2026-07-13 12:00:18 +08:00
..

🪦 Project Graveyard Agent Skill

Every developer has the folder. Twenty-something dead projects, each abandoned for reasons nobody wrote down.

This skill reads the git history of every abandoned project on your machine and answers three questions:

Why did each one die? Evidence, not vibes. The last commits touch Stripe files: it died at the payments wall. Another repo's first commit lands three days after this one's last: the killer gets named.

What's your pattern? Your projects die at day 19. Four of six were abandoned within 48 hours of starting something new.

Which one still has a pulse? Somewhere in that folder is a project that's 90% done: built, documented, never shipped. This finds it, checks what got easier since it died, and writes the short list of steps between it and a URL.

A representative scan (invented projects, real classifier verdicts). Your agent turns it into the funeral: an epitaph per corpse, your patterns named, and an offer to start resurrecting the strongest pulse right now. Yours will hurt more.

ChatGPT Image Jul 9, 2026, 06_46_05 PM

What it detects

Cause of death, read from git history:

Cause How it knows
shiny object Another repo you own had its first commit within days of this one's last. The killer is named.
deploy fear README done, 20+ commits, real code, zero deploy config. It worked. It never shipped.
payments / auth wall The final commits touch stripe/billing or oauth/login code.
boilerplate wall 60%+ of all file changes were config files. It died configuring.
rewrite spiral Multiple rewrite/migrate commits; rebuilt instead of finished.
scope explosion 100+ files, no deploy config. It grew instead of shipping.
slow fade Commit gaps stretched until they stopped. No wall, no killer; it drifted.

It also separates the finished (deployed, pushed, documented; done, not abandoned) from the unversioned (no git, so no autopsy). Then it ranks the dead by pulse, how close each is to shipping, and the agent takes over:

  • Autopsy interview: ambiguous deaths get a question; git evidence is marked (forensic), your answers (confirmed).
  • World-check: before prescribing a dig, it checks what changed since the death: the API that now has an SDK, the model that's 20x cheaper.
  • Resurrection: a ≤7-step plan ending at shipped, and an offer to start on step 1 right now.
  • Relapse watch: resurrections are recorded (--state + --mark-resurrected); every later scan reports whether the patient is holding.
  • Necromancer mode: ask your agent to build something new and it checks the graveyard first; you may have built 60% of it in 2024.

Install (10 seconds)

npx skills add https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/agent_skills/project-graveyard

The skills CLI installs it into whatever agents you have (Claude Code, Codex, Cursor, Copilot, Antigravity, and others); or copy this folder into your agent's skills dir. Then: "run the graveyard on ~/dev and ~/projects".

Standalone, no agent required:

python3 project-graveyard/scripts/graveyard.py ~/dev ~/projects

Scope and privacy

Everything runs locally: one plain-Python file, stdlib only, zero network calls, read-only. It reads git metadata (commit dates, messages, filenames), never your code's contents. Name folders and it scans only those; given none, it checks a fixed list of usual project spots (DEFAULT_ROOTS, line 30 of the script), never "everything on your machine." Want to post your report? --redact swaps project names for project-1..n.

Prove it works before installing, from a clone of this repo:

python3 agent_skills/evals/project-graveyard/test_graveyard.py   # 16 checks, ~10 seconds

Limits: no git means no autopsy (counted, not diagnosed). "Dead" is 45+ days silent, tunable with --days. Tested on macOS and Linux.

Files

project-graveyard/                  # ← this is all that gets copied
├── SKILL.md                        # agent instructions: report format, epitaph rules, resurrection protocol
├── README.md                       # this file
├── scripts/graveyard.py            # scanner + autopsy + pulse ranking (Python 3.8+, stdlib, offline)
└── references/causes-of-death.md   # the taxonomy: signals, confidence, resurrection strategy per cause

Part of awesome-llm-apps · Apache-2.0 · Last verified: July 2026