Will this skill delete my existing notes?

No, the skill focuses on moving files, updating templates, and modifying metadata. It provides a full plan for review before any destructive actions are taken.

Can I preview changes before they happen?

Yes, by using the --dry-run argument, you can view the complete restructuring plan and risk assessment without executing any changes.

What files are required for the refactor skill to work?

The skill requires ops/config.yaml and ops/derivation.md to establish the baseline and the desired target state for your project structure.

What is the difference between /architect and /refactor?

/architect analyzes vault health to recommend architectural shifts, while /refactor implements those changes across all affected files and templates.

Vault Refactor & Restructuring

Name: Vault Refactor & Restructuring
Author: LopeWale

byLopeWale

0•

Productivity & Workflow

Automates the restructuring of knowledge vaults and project infrastructures by detecting configuration shifts and managing artifact cascades.

The Refactor skill ensures your project's physical structure remains synchronized with its conceptual configuration. By comparing live configuration files against original derivation records, it identifies shifts in dimensions such as granularity, organization, and schema. It performs a comprehensive cascade analysis to determine how these changes affect folder structures, note templates, metadata, and automation hooks. Before any changes are made, it generates a detailed implementation plan and risk assessment, allowing for safe, approved migrations of complex knowledge bases or documentation systems.

Key Features

010 GitHub stars

02Safe execution workflow with mandatory approval and dry-run support

03Detailed impact reports with risk levels and affected artifact counts

04Multi-dimensional cascade analysis for folders, templates, and metadata

05Automated regeneration of dependent skills and context files

06Automated drift detection between config.yaml and derivation records

Use Cases

01Migrating metadata schemas and YAML templates across an entire vault

02Transitioning a flat note directory into a hierarchical Map of Content (MOC) system

03Updating processing pipelines when changing note extraction granularity

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lopewale/ampllabs refactor

For use in Claude.ai and ChatGPT