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

retire-skill

Move a skill directory to .claude/skills/archive/ and update AGENT.md references.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive a skill instead of deleting it, providing a fully reversible deactivation workflow that keeps historical references intact.

Core Features & Use Cases

  • Archive the target skill without permanent deletion, enabling restoration at any time.
  • Detect and warn about references to the skill in AGENT.md tables and offer options to update or remove those references.
  • Move the skill directory to the archive location .claude/skills/archive/<skill-name>/ and preserve a record for auditing.

Quick Start

Provide the skill name to retire, and the system will move it to .claude/skills/archive/<skill-name>/ for safe restoration later.

Frequently Asked Questions about retire-skill

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

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

Archiving a skill moves its directory to .claude/skills/archive/<skill-name>/, preserving all files for a fully reversible restoration instead of permanent deletion while hiding it from active lists.

What happens to AGENT.md references when I retire a skill?▼

When retiring a skill, the system detects references in AGENT.md tables, warns about them, and offers options to either update or remove those agent references accordingly to maintain consistency.

Can I restore an archived skill after moving it to the archive folder?▼

Yes, archiving is fully reversible. The skill directory is moved to .claude/skills/archive/<skill-name>/ rather than deleted, allowing you to restore the skill to active status at any time.

When should I archive a skill rather than delete it permanently?▼

You should archive a skill when you need to hide it from active lists but want to retain historical references and audit records, such as when maintaining agent references that depend on the skill.

Does the archive folder need to exist before I retire a skill?▼

No, the archive folder does not need to pre-exist. The system creates the .claude/skills/archive/ directory automatically if it is needed during the skill retirement process.

Related Skills

Explore More Software Engineering Skills→
cnfjlhjcnfjlhj
425

skills-governance

Audit local skill collections and generate JSON and markdown reports.

Community
Advanced
enbiyagoralenbiyagoral
2

restore-skill

Restore archived Claude skills by moving them to the active directory.

Community
Advanced
koki3141koki3141
2

checkpoint-manager

Create, verify, and list git snapshot workflow checkpoints.

Community
Intermediate
dezverevdezverev

sync-dev-guide

Synchronize GeneralDevGuide with skills, agents, and MCP server inventory.

Community
Basic