skills.rest
enbiyagoral
enbiyagoralCOMMUNITY
Explore all skills by this author →
GitHub

retire-agent

Archive Claude agents to .claude/agents/archive/ using git mv.

2|1|Updated Mar 24, 2026
Search Tags:#git#workflow#claude#agent#archive#version-control#retire
One-click install
npx skills add https://github.com/enbiyagoral/.claude --skill retire-agent
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: retire-agent
Source: https://github.com/enbiyagoral/.claude/tree/main/.claude/skills/retire-agent
Command: npx skills add https://github.com/enbiyagoral/.claude --skill retire-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive an agent instead of deleting it — fully reversible, enabling restoration at any time.

Core Features & Use Cases

  • Reversible retirement: move agents to .claude/agents/archive/ instead of permanent deletion.
  • Type-agnostic archiving: supports both Type A (.claude/agents/<name>.md) and Type B (.claude/agents/<name>/) agents.
  • Restore path: restore by moving the agent back from the archive to its original location.

Quick Start

Confirm retirement when prompted to move the agent to the archive directory.

Frequently Asked Questions about retire-agent

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

FAQPage Schema
How do I archive a Claude agent instead of deleting it?▼

To archive a Claude agent, you move it to the .claude/agents/archive/ directory. This preserves the agent files for restoration instead of permanently deleting them from your project.

Can I archive both single-file and directory-based Claude agents?▼

Yes, you can archive both Type A (.claude/agents/<name>.md) and Type B (.claude/agents/<name>/) Claude agents. The archiving process validates paths and moves either format to the archive directory.

How does git mv work when retiring an agent?▼

When retiring an agent, git mv moves the agent files into the archive directory if git is available. This tracks the file movement in version control, creating the archive folder if it does not already exist.

What is the best way to restore a retired agent from the archive?▼

Restoring a retired agent involves moving it back from the .claude/agents/archive/ directory to its original location. This reversible retirement process ensures you can reactivate agents at any time.

Does archiving an agent prompt for confirmation before moving files?▼

Yes, archiving an agent prompts for confirmation before moving the files. This validation step ensures you intentionally want to retire the deactivated or inactive agent to the archive directory.

Related Skills

Explore More Software Engineering Skills→
VanLengsVanLengs
1

init

Initialize a git-tracked studio workspace with config and directories.

Community
Intermediate
enbiyagoralenbiyagoral
2

restore-agent

Restore archived agents from .claude/agents/archive to active use with conflict checks.

Community
Advanced
ZhanlinCuiZhanlinCui
178

doc-sync-tool

Synchronize Agents.md, claude.md, and gemini.md across nested project directories.

Community
Intermediate
Rust-sohamRust-soham

golem-delete-agent

Delete agent instances and permanently remove their oplog and memory state.

Community
Basic