project-remove

Remove project symlinks and junctions while preserving target folder data.

Updated Jan 1, 2026
One-click install
npx skills add https://github.com/AirMile/claude-config --skill project-remove
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-remove
Source: https://github.com/AirMile/claude-config/tree/main/skills/project-remove
Command: npx skills add https://github.com/AirMile/claude-config --skill project-remove

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Safely unregisters a project by removing its Claude-specific links (symlinks or junctions) without touching the actual project data, preventing accidental data loss.

Core Features & Use Cases

  • Safe unlink of project-specific links in macOS (symlinks) and Windows (junctions).
  • Validates that the target project exists and that links exist before removal.
  • Interactive prompts and safety checks ensure master config remains intact.

Quick Start

Run /project-remove with the project name to start the unregister flow and follow the on-screen prompts.

Frequently Asked Questions about project-remove

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

FAQPage Schema
How do I safely remove symlinks and junctions without deleting the target folder data?

To safely remove symlinks and junctions without data loss, you must unregister the project links while preserving the target folder. This ensures only the project links are removed and the actual project data remains intact on macOS and Windows.

Does Claude Code project removal work on both macOS and Windows?

Yes, Claude Code project removal works on both macOS and Windows by handling cross-platform links. It safely removes symlinks on macOS and junctions on Windows, validating that links exist before removal to prevent accidental data deletion.

What is the best way to unregister a project managed under Claude Code?

The best way to unregister a Claude Code managed project is to use an interactive removal flow with safety checks. This validates the target project exists and uses safe user prompts to ensure the master config remains intact during link cleanup.

Why does removing a project link leave the master config intact?

Removing a project link leaves the master config intact because the unregister process applies safety checks that specifically target only project-specific links. It preserves the master configuration while cleaning up symlinks and junctions.

Can I delete a project symlink without accidentally losing my actual project files?

Yes, you can delete a project symlink without losing actual project files by using a validated link cleanup process. This removes the Claude-specific links while explicitly preserving the target folder data stored separately from the link.

What are the limitations of cleaning up Claude config links manually?

Cleaning up Claude config links manually risks accidental data loss and master config corruption. Manual removal lacks the interactive prompts, cross-platform validation, and safety checks needed to ensure only project links are removed without touching target folders.