skill-maintenance

Batch rename SKILL.md directories and update cross-references by executing automated git operations that rename directories, edit metadata, batch-replace terms, and commit changes. A structured 9-step workflow guides the entire refactoring process.

Maintaining naming consistency across multiple SKILL.md files requires a structured workflow that analyzes outdated terminology, proposes renames, updates references, and generates a maintenance report to verify no stale references remain.

Yes, you can automate refactoring terminology across a skills directory using bash shell commands. The process requires file system access to batch-replace terms, edit SKILL.md metadata, and commit directory rename changes via git.

Prevent stale cross-references when renaming skill directories by using built-in safety checks that verify no outdated references remain after batch-replacing terms and updating SKILL.md metadata, followed by generating a detailed maintenance report.

You should avoid large-scale refactoring of your skills directory when safety checks indicate potential over-refactoring risks. The workflow includes specific precautions to prevent over-refactoring and verify reference integrity before committing git changes.