organize-files

Restructure, deduplicate, and re-index a shared Markdown notes directory.

Updated Jul 15, 2026
One-click install
npx skills add https://github.com/Kurorz2004/alphaz-coral --skill organize-files-kurorz2004
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: organize-files
Source: https://github.com/Kurorz2004/alphaz-coral/tree/main/vrp/evidence/full/full-s1/.coral/public/skills/organize-files
Command: npx skills add https://github.com/Kurorz2004/alphaz-coral --skill organize-files-kurorz2004

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Shared notes directories accumulate flat files, duplicates, inconsistent naming, and broken cross-links as multiple agents contribute, making it hard to find existing research and experiment records. ## Core Features & Use Cases - Audit and Planning: Run a read-only audit script to count files, flag naming issues, and detect recent activity before planning a target structure within research/ and experiments/. - Deduplication with Provenance: Detect near-duplicate notes via weighted Jaccard similarity, optionally delegate ambiguous pairs to a blinded Dedup Judge subagent, and merge while unioning references, tags, and claims. - Safe Moves and Link Repair: Move and rename notes with frontmatter breadcrumbs, regenerate index.md, and resolve broken wikilinks after restructuring. - Use Case: After several deep-research sessions leave 24 flat notes with duplicates and exp-NNN filenames, reorganize them into topic subdirectories, merge duplicates into an archive, and regenerate a clean index. ## Quick Start Ask the agent to audit the shared notes directory and reorganize research and experiments notes into topic-based subdirectories, merging duplicates and updating the index.

Frequently Asked Questions about organize-files

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

FAQPage Schema
How do I organize a messy shared notes directory?

Run the audit script to assess the current state, plan a target structure grouping notes into topic subdirectories with at least 3 files each, then deduplicate, move files with the move script, regenerate the index, and log the changes.

How do I find duplicate Markdown notes automatically?

Use find_duplicates.py, which computes weighted Jaccard similarity over note titles and first paragraphs and reports pairs above a configurable threshold (default 0.5). Treat the score as a candidate signal and read both notes before merging.

How do I merge duplicate notes without losing references?

Union the References sections from both notes, keep the more specific claims from each, combine tags and aliases, and move the originals to an _archive/ directory so the merge stays reversible.

Does the move script protect against concurrent edits?

Yes, move_note.py refuses to move files modified within the last 5 minutes unless forced, writes and verifies the destination before deleting the source, and records moved_from and moved_at in frontmatter.

What happens to broken links after renaming notes?

Run resolve_links.py after all moves complete; it scans note bodies for plain-text title mentions and wraps them as wikilinks, skipping existing links, citations, and code blocks. Markdown-style relative links must be fixed manually.