skf-rename-skill

What problem does it solve?

Manually renaming a skill across all its versioned directories, manifest entries, and platform context files is error-prone and risks broken references or permanent data loss if the old skill is deleted before all updates are verified. This Skill eliminates that risk by providing a fully transactional, atomic rename workflow that guarantees the original skill remains intact if any step fails.

Core Features & Use Cases

• Transactional Safety: Uses a copy-verify-delete pattern to ensure the new skill name is fully materialized and verified before the old name is removed, so any failure leaves the original skill untouched.
• Comprehensive Reference Updates: Automatically updates all required locations including SKILL.md frontmatter, metadata.json, context-snippet.md, provenance-map.json, export manifests, and platform context files like CLAUDE.md and .cursorrules.
• Validation & Guardrails: Validates new names against the agentskills.io kebab-case spec, checks for name collisions, warns about official source authority mismatches, and handles orphaned draft skills with no manifest entries.
• Use Case: You have a skill named "legacy-helper" with 3 versioned releases that you want to rename to "modern-helper". This Skill will rename all directories, update every reference, rebuild platform context files, and only delete the old directories after full verification, with zero manual file edits required.

Quick Start

Ask to rename your existing "old-skill-name" to "new-skill-name" and the Skill will handle all file updates, reference fixes, and platform context rebuilds across every version automatically.