project-graveyard

Analyzes git history of abandoned local projects to diagnose causes of death and rank resurrection candidates.

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/Protremix/EvolvixOS --skill project-graveyard-protremix
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-graveyard
Source: https://github.com/Protremix/EvolvixOS/tree/main/knowledge/skills/project-graveyard
Command: npx skills add https://github.com/Protremix/EvolvixOS --skill project-graveyard-protremix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Developers accumulate folders of abandoned side projects with no record of why each one died or which ones are worth finishing. This Skill scans local git repositories, reconstructs the cause of death for each abandoned project from commit history, surfaces personal abandonment patterns, and identifies the project closest to being shippable. ## Core Features & Use Cases - Forensic autopsy from git history: Classifies each dead project by cause (shiny object, deploy fear, payments/auth wall, boilerplate wall, rewrite spiral, scope explosion, slow fade) with evidence lines drawn from commit dates, messages, and touched files. - Pattern detection and pulse ranking: Aggregates statistics like median project lifespan and repeated death causes, then scores each corpse 0-100 on resurrectability based on README, tests, commit count, and deploy config. - Resurrection planning and relapse watch: Produces a step-by-step shipping plan for the top candidate, records resurrections in a state file, and flags projects that go silent again on later scans. - Use Case: Point it at ~/dev and ~/projects to get a tombstone report of 12 dead projects, learn that four were killed by newer projects within days, and receive a 7-step plan to finally ship the one that was 90% done. ## Quick Start Ask your agent to run the graveyard scan on your dev and projects folders and report which abandoned project is most worth resurrecting.

Frequently Asked Questions about project-graveyard

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

FAQPage Schema
How do I find and analyze abandoned side projects on my machine?▼

Run the graveyard.py script with the directories where your projects live, such as python3 graveyard.py ~/dev ~/projects. It scans for git repos, classifies each dead project by cause of death, and ranks them by resurrection potential.

How does git history reveal why a project was abandoned?▼

The scanner reads commit dates, messages, and filenames to detect patterns: final commits touching Stripe or auth code indicate a payments or login wall, 60%+ config file touches indicate a boilerplate death, and a newer repo starting within 14 days indicates a shiny-object killer.

Does the graveyard scanner send my code or data anywhere?▼

No. The script is a single Python file using only the standard library, runs entirely offline, and is read-only. It reads git metadata like commit dates and filenames, never file contents, and makes zero network calls.

Can I scan projects committed under a different git email?▼

Yes. By default repos where you authored under 20% of commits are skipped as not yours. Pass --me your-other@email.com (repeatable) to claim commits made under work addresses or builder tools, or use --include-foreign to include everything.

What are the limitations of git-based project autopsy?▼

Projects without git history cannot be autopsied, only counted as unversioned. The dead threshold defaults to 45 days of silence, so stable finished tools can look dead, and causes like slow fade show the shape of abandonment but not the underlying reason.