skills.rest
jamieadams-nerd
jamieadams-nerdCOMMUNITY
Explore all skills by this author →
GitHub

project-cleanup

Merge stray local.settings.json files into .claude/settings.json and consolidate .claude directories.

Updated Dec 4, 2025
Search Tags:#automation#claude#maintenance#cleanup#repository#plan-retirement
One-click install
npx skills add https://github.com/jamieadams-nerd/umrs-project --skill project-cleanup-jamieadams-nerd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-cleanup
Source: https://github.com/jamieadams-nerd/umrs-project/tree/main/.claude/skills/project-cleanup
Command: npx skills add https://github.com/jamieadams-nerd/umrs-project --skill project-cleanup-jamieadams-nerd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates repository housekeeping tasks to keep the umrs-project clean by merging stray local.settings.json files into .claude/settings.json, consolidating rogue .claude directories, and retiring completed Claude plans.

Core Features & Use Cases

  • Automated local.settings.json merge: merges into .claude/settings.json with top-level keys taking precedence on conflicts.
  • Rogue directory consolidation: finds non-top-level .claude/ directories and moves their contents under the top-level .claude/, preserving structure where sensible.
  • Plan retirement & reporting: identifies completed plans in .claude/plans/ and relocates them to .claude/plans/completed/, ensuring a completed status.

Quick Start

Run this skill to merge stray local.settings.json files into .claude/settings.json, consolidate rogue .claude directories, and retire completed Claude plans.

Frequently Asked Questions about project-cleanup

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

FAQPage Schema
How do I consolidate stray local.settings.json files into .claude/settings.json?▼

Repository cleanup automates merging stray local.settings.json files into .claude/settings.json, with top-level keys taking precedence on conflicts to ensure deterministic settings consolidation and traceable changes.

What's the best way to merge rogue .claude directories in a repository?▼

Repository housekeeping finds non-top-level .claude directories and consolidates their contents under the top-level .claude directory, preserving the original structure where sensible during the cleanup sweep.

How do I retire completed Claude plans from the .claude/plans directory?▼

Plan retirement identifies completed plans in .claude/plans/ and relocates them to .claude/plans/completed/, ensuring a completed status is set while providing reporting for traceable changes.

Does automated repository cleanup work across all branches and environments?▼

Yes, the cleanup skill applies to the umrs-project repository across all branches and environments where maintenance sweeps are performed, running deterministic passes for merging, consolidation, and retirement.

How are conflicts handled when merging local.settings.json into .claude/settings.json?▼

When merging local.settings.json files into .claude/settings.json, top-level keys take precedence on conflicts, ensuring deterministic resolution and preventing settings loss during the repository housekeeping process.

Related Skills

Explore More Software Engineering Skills→
lushly-devlushly-dev
4

do-clean-repo

Scan and clean repository clutter including stale branches, orphaned worktrees, and build output.

Official
Intermediate
alexica00alexica00

git-worktree-clean

Clean stale git worktrees and merged branches with protected branch safeguards.

Community
Intermediate
hellowind777hellowind777
654

kb

Automate knowledge base governance and lifecycle management for HelloAGENTS projects.

Community
Advanced
bossjonesbossjones
1

worktree-doctor

Analyze Git repository files and suggest .worktreeinclude configurations.

Community
Intermediate