skills.rest
buvis
buvisOFFICIAL
Explore all skills by this author →
WebsiteGitHub

audit-project-orphans

Identify orphaned Claude project configurations under ~/.claude/projects by verifying source paths.

2|Updated Dec 20, 2020
Search Tags:#audit#bash#maintenance#cleanup#filesystem#orphan#project-config
One-click install
npx skills add https://github.com/buvis/home --skill audit-project-orphans
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit-project-orphans
Source: https://github.com/buvis/home/tree/main/.claude/skills/audit-project-orphans
Command: npx skills add https://github.com/buvis/home --skill audit-project-orphans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use when the user wants to find stale or orphaned project configs in ~/.claude/projects/. Triggers on "audit project orphans", "orphan projects", "stale projects", "clean up projects", "which projects are orphaned", "project cleanup".

Core Features & Use Cases

  • Scan the project directory to identify configurations whose source paths are missing or inactive.
  • Flag orphaned configs for cleanup and report dorm ant projects based on last activity.
  • Use Case: Regular maintenance to keep ~/.claude/projects clean and up-to-date.

Quick Start

Identify orphaned and dormant Claude project configurations under ~/.claude/projects by verifying their source paths.

Frequently Asked Questions about audit-project-orphans

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

FAQPage Schema
How do I find orphaned Claude project configurations in ~/.claude/projects?▼

You can identify stale Claude project configs by running an audit that verifies source paths under ~/.claude/projects. It checks path existence via sessions-index.json or encoded directory names, flags orphaned entries, and generates a structured report of inactive projects for cleanup.

What is the best way to clean up unused Claude project configs and reclaim disk space?▼

Cleaning up unused Claude project configs involves auditing ~/.claude/projects to detect orphaned entries. The audit calculates disk usage and last-session dates, pinpointing dormant configurations safe for removal to reclaim disk space and keep your project inventory accurate.

How does path resolution work when checking for dormant Claude projects?▼

Path resolution checks dormant Claude projects by validating source paths using sessions-index.json or decoding encoded directory names. It verifies the original project directory's existence on the filesystem to determine whether a configuration is orphaned or still active.

Can I use a bash audit script to maintain an accurate Claude project inventory?▼

Yes, a bash audit can maintain an accurate Claude project inventory. It scans ~/.claude/projects, verifies source paths, computes disk usage, determines last-session dates, and outputs a structured report to help track and clean up stale configurations.

When should I run a project cleanup audit on my Claude projects directory?▼

Run a project cleanup audit on your Claude projects directory during regular maintenance. Apply it when you need to find stale or orphaned configs, reclaim disk space from unused entries, and ensure your ~/.claude/projects folder remains clean and up-to-date.

Related Skills

Explore More Software Engineering Skills→
bdambrosiobdambrosio
10

fs-list

List files and directories within a filesystem sandbox path using Python's pathlib.

Community
Basic
plurigridplurigrid
60

storage-reclaim

Identify and reclaim disk space from build artifacts, caches, and temporary files.

Official
Basic
JansenAnalyticsJansenAnalytics
5

health-check

Monitor Linux disk, memory, services, and load for threshold anomalies.

Community
Intermediate
NodewarriorNodewarrior
21

spine-scan

Detect vault decay and undocumented changes in Spine-managed Obsidian knowledge bases.

Community
Advanced