reorganize

Migrate OneBrain vaults from 5-folder to 8-folder layouts and organize flat notes into kebab-case subfolders.

23|2|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/onebrain-ai/onebrain --skill reorganize-onebrain-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reorganize
Source: https://github.com/onebrain-ai/onebrain/tree/main/.claude/plugins/onebrain/skills/reorganize
Command: npx skills add https://github.com/onebrain-ai/onebrain --skill reorganize-onebrain-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you migrate and reorganize your OneBrain vault structure when you need a full-layout change, instead of doing risky, note-by-note moves that can leave the vault inconsistent.

Core Features & Use Cases

  • Legacy 5-folder → 8-folder migration: adds required folders (areas/resources/agent memory), renumbers archive/logs, and classifies old knowledge notes into resources vs knowledge.
  • Subfolder organization for flat notes: moves top-level flat notes into kebab-case subfolders (up to two levels) based on content and frontmatter.
  • Safety guardrails: explicitly instructs manual-only, high-impact usage and includes an abort condition for outdated 07-logs structure (requires running /update first).

Use cases: reorganizing an older vault onto the current 8-folder layout, or organizing a flat vault into a cleaner category-based hierarchy after upgrading.

Quick Start

Ask OneBrain to run /reorganize to migrate your vault structure after you confirm you want a full reorganization and (if applicable) you have run /update.

Frequently Asked Questions about reorganize

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

FAQPage Schema
How do I migrate an OneBrain vault from a 5-folder to an 8-folder layout?

To migrate an OneBrain vault to the 8-folder layout, you run a full vault restructuring process that adds required folders like areas, resources, and agent memory, renumbers archive and logs, and classifies old knowledge notes into resources versus knowledge categories.

What is the best way to organize flat notes into kebab-case subfolders?

Organizing flat notes into kebab-case subfolders involves moving top-level notes into up to two levels of category folders based on content and frontmatter classification rules. This approach restructures a flat vault into a cleaner category-based hierarchy.

Do I need to run an update before reorganizing an outdated logs structure?

You need to run an update before reorganizing an outdated 07-logs structure because the vault reorganization process includes an abort condition for outdated logs. Running the update first ensures the logs structure is compatible with the migration.

Does vault reorganization provide audit logging for folder migration?

Vault reorganization provides audit logging by writing an audit-log process with per-run mode discrimination during folder migration. This ensures that all structural changes and note movements are tracked for data safety and consistency.

Can I use frontmatter classification to sort notes during a full vault restructuring?

You can use frontmatter classification to sort notes during a full vault restructuring because the process applies classification rules to categorize old knowledge notes and move top-level flat notes into appropriate subfolders based on their content and metadata.

What are the limitations of using a full vault reorganization for note-by-note moves?

Full vault reorganization is limited to complete layout changes like 5-folder to 8-folder migration and kebab-case subfolder moves, meaning it is not intended for risky note-by-note moves that can leave the vault inconsistent and requires confirmation-based execution.