What does the refactor skill actually do?

It detects discrepancies between your intended vault configuration and its current state, then plans and executes the necessary file moves, template updates, and skill regenerations to align them.

Will I lose data during a vault restructure?

No. The skill provides a detailed impact report and risk assessment first, and only executes changes after your explicit approval. It also logs changes to a changelog for reference.

What are 'dimensions' in this context?

Dimensions are the eight core attributes of an arscontexta vault, including granularity, organization, linking, processing, navigation, maintenance, schema, and automation.

How do I preview changes before they happen?

You can use the --dry-run argument with the /refactor command to see the full restructuring plan without triggering any actual file modifications.

Does it update existing notes or just new ones?

It assesses content impact for existing notes. Depending on the change, it can identify which notes need metadata updates or folder migrations to maintain system integrity.

Knowledge Vault Refactor

Name: Knowledge Vault Refactor
Author: agenticnotetaking

byagenticnotetaking

•

2,813

•

生产力与工作流

Synchronizes knowledge base architecture with configuration changes by planning and executing multi-dimensional vault restructures.

The Vault Refactor skill automates the complex task of updating personalized knowledge systems when their underlying architectural requirements change. By comparing current configurations against original derivation records, it identifies 'dimension shifts'—such as changes in organizational hierarchy, note granularity, or metadata schemas. The skill performs a comprehensive cascade analysis to determine how these shifts affect templates, skills, and folder structures, providing a detailed impact report and risk assessment before any changes are made. This ensures that digital second brains remain consistent and functional even as a user's thinking process evolves.

主要功能

012,813 GitHub stars

02Dry-run capabilities for previewing architectural changes without execution

03Comprehensive restructuring plans with risk and content impact assessments

04Automated regeneration of affected skills and context-sensitive templates

05Multi-dimensional cascade analysis covering granularity, linking, and organization

06Automated drift detection between active config and derivation baselines

使用场景

01Migrating a knowledge vault from a flat file structure to a hierarchical MOC system

02Updating metadata schemas across hundreds of markdown notes simultaneously

03Adjusting the processing depth and automation levels of a digital second brain

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agenticnotetaking/arscontexta refactor

For use in Claude.ai and ChatGPT

Download Skill