skill-cleanup

Removes transient session-fetched skills from ~/.claude/skills/ using the .session-skills manifest.

Updated Feb 11, 2026
One-click install
npx skills add https://github.com/lamb92009/claude-skills --skill skill-cleanup-lamb92009
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-cleanup
Source: https://github.com/lamb92009/claude-skills/tree/main/skill-cleanup
Command: npx skills add https://github.com/lamb92009/claude-skills --skill skill-cleanup-lamb92009

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Removes session-fetched skills from ~/.claude/skills/ using the .session-skills manifest, keeping the directory lean between sessions.

Core Features & Use Cases

  • Validate presence of the manifest and report when missing.
  • Read the manifest to determine which skills were loaded this session.
  • Remove each listed skill directory from ~/.claude/skills/, ensuring permanent residents are never deleted.
  • Remove the manifest after cleanup to restore a lean baseline for the next session.
  • Confirm the resulting skill directory state and report changes.

Quick Start

Run the skill-cleanup command after a session to remove all transient skills and restore the lean baseline.

Frequently Asked Questions about skill-cleanup

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

FAQPage Schema
How do I clean up transient skills from my Claude session cache?

To clean up transient skills from your Claude session cache, you can use a cleanup tool that reads the .session-skills manifest to identify and safely remove session-fetched skill directories from ~/.claude/skills/.

What is a .session-skills manifest used for in skill management?

A .session-skills manifest is used to track which skills were loaded during a specific session. It serves as a reference list to determine exactly which transient skill directories need to be removed during cleanup.

How do I remove temporary skills without deleting my permanent ones?

To remove temporary skills without deleting permanent ones, the cleanup process parses the session manifest and strictly targets only the listed directories, ensuring permanent resident skills in ~/.claude/skills/ are preserved.

When should I run a session skill cleanup on my Claude environment?

You should run a session skill cleanup after a session ends to remove all transient skills and restore a lean baseline state for the next session, keeping the skill directory uncluttered.

What happens if the .session-skills manifest is missing during cleanup?

If the .session-skills manifest is missing during cleanup, the process validates its presence and will report that it is missing, preventing the accidental deletion of directories without a tracking reference.