rename-skill

Rename an agent skill directory, frontmatter name, and codebase references.

138|6|Updated Jan 25, 2025
One-click install
npx skills add https://github.com/yamcodes/arkenv --skill rename-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rename-skill
Source: https://github.com/yamcodes/arkenv/tree/main/skills/rename-skill
Command: npx skills add https://github.com/yamcodes/arkenv --skill rename-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This action enables you to rename an existing agent skill within your workspace while updating its directory name, the frontmatter name, and all codebase-wide references to reflect the new identifier.

Core Features & Use Cases

  • Rename the skill directory (e.g., skills/<old-name> to skills/<new-name>) and update the frontmatter to reflect the new name.
  • Preserve attribution and provenance data (e.g., original_author, origin) while performing the rename.
  • Audit and update internal references across docs and configurations to ensure consistency after the rename.

Quick Start

Rename the target skill directory from skills/<old-name> to skills/<new-name> and update the frontmatter name accordingly.

Frequently Asked Questions about rename-skill

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

FAQPage Schema
How do I rename a skill directory and update all references in my codebase?

To rename a skill, you change the workspace directory name and update the frontmatter identifier. This process also audits and updates internal references across docs and configurations to ensure project-wide consistency.

Does renaming an agent skill preserve attribution metadata like original author?

Yes, renaming an agent skill preserves attribution and provenance data such as original_author and origin. It only updates the directory name, frontmatter, and internal flags while maintaining the original creation metadata.

What happens to internal references when I restructure skill folder layouts?

When you restructure skill folder layouts, the rename action audits and updates internal references across docs and configurations. This ensures that all codebase-wide references reflect the new identifier and maintain a consistent identity.

Can I update the frontmatter name without breaking codebase-wide references?

Yes, you can update the frontmatter name safely. The rename process automatically audits and updates internal references across the entire codebase, ensuring that changing identifiers does not break existing configurations or documentation.

When should I use an automated skill rename instead of manual folder renaming?

You should use an automated skill rename when reorganizing internal or external skills and changing identifiers. It prevents broken references by automatically updating the directory, frontmatter, and codebase-wide configurations simultaneously.