Agent skill

Reorg

by flonat in flonat/flonat-research

Propose and, after approval, execute content-aware file reorganization or deduplication using a local Mac Mini model with a reversible undo record.

MITAuto-check passedData & Analytics

Install Reorg

skills CLI
$ npx skills add flonat/flonat-research --skill reorg -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install flonat/flonat-research reorg --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/flonat/flonat-research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/reorg .claude/skills/reorg && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
reorg
GitHub stars
145
Token cost
~989 tokens
SKILL.md length
498 words
Files
1
Skills in repo
83
Repo updated
First seen
Licence
MIT

At a glance

Propose and, after approval, execute content-aware file reorganization or deduplication using a local Mac Mini model with a reversible undo record.

  • Works in 6 steps: Confirm the target folder and pick a… → Dry-run — never skip this → Read the plan file and summarise it for… → …
  • Sorting a folder by file contents
  • SKILL.md covers When to use, How to invoke the CLI, Workflow and Options worth surfacing, plus 2 more sections
  • Calls git and ssh

What it does

Reorg is an agent skill from flonat/flonat-research. Propose and, after approval, execute content-aware file reorganization or deduplication using a local Mac Mini model with a reversible undo record. Use when sorting a folder by file contents or finding exact and near duplicates. Always dry-runs first.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Data & Analytics, covering Data cleaning. The repository describes itself as: Shareable Claude Code + Codex infrastructure for PhD researchers — skills, agents, hooks, and rules for academic workflows. The licence is MIT.

When your agent uses it

  • Sorting a folder by file contents
  • Finding exact and near duplicates

Example prompts

  • “/reorg”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Confirm the target folder and pick a mode with the user if unclear
  2. Dry-run — never skip this
  3. Read the plan file and summarise it for the user — group counts, notable moves, and
  4. Get approval. The user may edit .reorg/plan.json first (trim/retarget moves).
  5. Execute only after a clear yes
  6. Offer undo: reorg --undo reverses the most recent applied/quarantined run

What it can do on your machine

Read from SKILL.md and the folder at commit da27600. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • ssh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and ssh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reorg loads about 989 tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 498 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~989

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from flonat/flonat-research at commit da27600, republished under its MIT licence (© flonat). 498 words, ~989 tokens.

Download SKILL.mdSave it as .claude/skills/reorg/SKILL.md (or your agent's skills folder).
name
reorg
description
Propose and, after approval, execute content-aware file reorganization or deduplication using a local Mac Mini model with a reversible undo record. Use when sorting a folder by file contents or finding exact and near duplicates. Always dry-runs first.

reorg — local-model file reorganiser

Conversational front-end for the local-reorg CLI (scripts/local-reorg/). The CLI runs a local Ollama model on the Mac Mini that reads each file's content and proposes where it should go, or finds duplicates. Nothing is ever moved without your approval, and every run is reversible.

When to use

  • "Reorganise / tidy / sort this folder" where you want the model to read files, not just pattern-match filenames.
  • "Find duplicates" / "dedup this folder" (exact + near-duplicate via embeddings).
  • General clutter (Downloads, Desktop, a messy project subfolder).

For research-project structural changes use an installed project-renaming or project-initialization workflow; if none is available, use a normal reviewed git mv plan with explicit backlink and configuration checks. For meeting to-sort/ inboxes, use the project's inbox-processing workflow. This skill is general-purpose file tidying.

How to invoke the CLI

First hostname:

  • On the Mac Mini ([server]): the reorg shim is on PATH — call reorg … directly.
  • Anywhere else (MacBook, etc.): run the installed Mini wrapper over SSH: ssh mini '~/.local/bin/reorg <args>'

The model + files both live on the Mini, so resolve the target using the Mini's Task Management path registries before invoking the wrapper. Do not embed either machine's physical Dropbox root. If you cannot resolve the path unambiguously, ask.

Workflow

  1. Confirm the target folder and pick a mode with the user if unclear:
    • reorg by scheme: auto (default) · by-type · by-topic · by-date
    • dedup: --dedup (report) → --dedup --quarantine (move redundant copies aside)
  2. Dry-run — never skip this:
    • reorg: reorg <folder> [--scheme X] [--recursive]
    • dedup: reorg <folder> --dedup The CLI writes <folder>/.reorg/plan.md (reorg) or .reorg/duplicates.md (dedup).
  3. Read the plan file and summarise it for the user — group counts, notable moves, and any ⚠low-conf items. Do not dump the whole file; give a scannable summary and the path.
  4. Get approval. The user may edit .reorg/plan.json first (trim/retarget moves).
  5. Execute only after a clear yes:
    • reorg: reorg <folder> --apply (add --yes if ≥20 moves — tell the user it's the break-the-glass threshold)
    • dedup: reorg <folder> --dedup --quarantine
  6. Offer undo: reorg <folder> --undo reverses the most recent applied/quarantined run (LIFO). Mention it after any execution.
Show full SKILL.md (151 more words)Show less

Options worth surfacing

  • --model gemma4:e2b — ~1.5× faster than the default gemma4:e4b, slightly less accurate. Suggest it for large folders.
  • --max-files N — default 200; raise for big sweeps (warn about time: ~5–6 s/file on e4b).
  • --dedup-threshold 0.95 — stricter near-match (default 0.92; paraphrases ~0.96).

Safety (the CLI enforces; restate to the user)

  • Refuses Overleaf (Apps/Overleaf/), the vault (vault/), AI client homes, and anything under data/raw/ or .git/. Don't try to work around this.
  • Never deletes. Reorg moves into subfolders; dedup quarantines into .reorg/duplicates/.
  • git mv for tracked files; undo manifest on every applied run.
  • The dry-run → approve → apply loop is mandatory. Do not run --apply/--quarantine before showing the plan and getting a yes.

Requirements

Ollama must be running on the Mini with gemma4:e4b (or the chosen model) + nomic-embed-text for dedup, plus pdftotext. All present as of setup. If Ollama is unreachable the CLI exits with a clear message — relay it rather than guessing.

© flonat, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/reorg of flonat/flonat-research.

Open the folder on GitHubat commit da27600

Compare with similar skills

Reorg next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Reorg compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reorg this skillflonat/flonat-research145—~989Automated safety check: PassMIT
Question2reportrefraction-ray/xalpha2.7k—~3.2kAutomated safety check: PassMIT
Dingo VerifyMigoXLab/dingo757—~741Automated safety check: NotesApache-2.0
Data Validationplatonai/Browser41.2k—~896Automated safety check: PassApache-2.0
Issues DeduplicationJetBrains/ideavim10k—~1.3kAutomated safety check: PassMIT
Pandas ProJeffallan/claude-skills12k1 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • Question2report

    refraction-ray/xalpha

    Turn a natural-language financial question into a polished, self-contained HTML report.

    2.7k GitHub stars~3.2k tokensUpdated 2 mo ago
    Data & AnalyticsAuto-check passed
  • Dingo Verify

    MigoXLab/dingo

    A skill your agent uses when the user wants to fact-check an article or verify factual claims in a document.

    757 GitHub stars~741 tokensUpdated 10 days ago
    Data & AnalyticsAuto-check: notes
  • Data Validation

    platonai/Browser4

    Validates data against common and custom rules (required fields, formats, ranges).

    1.2k GitHub stars~896 tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Issues Deduplication

    JetBrains/ideavim

    Official

    Handles deduplication of YouTrack issues. An agent skill from JetBrains/ideavim.

    10k GitHub stars~1.3k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Pandas Pro

    Jeffallan/claude-skills

    Handles pandas DataFrame work: cleaning, merging, groupby aggregation, pivots, time-series resampling and memory tuning, with checks on dtypes, shapes and nulls.

    12k GitHub starsUsed in 1 repo~1.5k tokens
    Data & AnalyticsAuto-check passed
  • Openbb Data Fetcher

    monarchjuno/vibe-investing

    Fetch financial, market, economic, fundamental, news, options, crypto, ETF, index, and macro data through the OpenBB Python interface instead of the OpenBB MCP server.

    299 GitHub stars~2.9k tokensUpdated 5 mo ago
    Data & AnalyticsAuto-check: notes

More from flonat/flonat-research

All 83 skills in this repo
  • Latex Posters

    flonat/flonat-research

    Create a large-format academic poster in LaTeX using beamerposter, tikzposter, or baposter.

    145 GitHub stars~1.5k tokensUpdated 9 days ago
    Auto-check: notes
  • Skill Creator

    flonat/flonat-research

    Create, revise, and evaluate reusable AI workflow skills, including trigger-quality tests.

    145 GitHub stars~4.4k tokensUpdated 9 days ago
    Auto-check passed
  • DOCX

    flonat/flonat-research

    Create, read, edit, or convert Microsoft Word documents while preserving professional document structure.

    145 GitHub stars~1.2k tokensUpdated 9 days ago
    Auto-check passed
  • PDF

    flonat/flonat-research

    Read, create, combine, split, rotate, OCR, watermark, secure, or extract content from PDF files.

    145 GitHub stars~488 tokensUpdated 9 days ago
    Auto-check passed
  • Init Project Orchestration

    flonat/flonat-research

    Create or migrate project-level agents, repeatable project workflows, and planning state from one client-neutral contract, then render repository-scoped adapters for both Claude Code and Codex.

    145 GitHub stars~1.6k tokensUpdated 9 days ago
    Auto-check passed
  • Pre Commit Audit

    flonat/flonat-research

    Deliver a fast pre-commit safety scan: file size, anonymity (author / affiliation strings in tex/bib), hardcoded secrets, and invisible-Unicode carriers.

    145 GitHub stars~2.8k tokensUpdated 9 days ago
    Auto-check: notes

Questions about Reorg

What does Reorg do?

Propose and, after approval, execute content-aware file reorganization or deduplication using a local Mac Mini model with a reversible undo record. Reorg is an agent skill from flonat/flonat-research. Propose and, after approval, execute content-aware file reorganization or deduplication using a local Mac Mini model with a reversible undo record.

When should I use Reorg?

Reorg fits situations like: sorting a folder by file contents; finding exact and near duplicates.

How do I install Reorg in Claude Code?

Run `npx skills add flonat/flonat-research --skill reorg -a claude-code`. Or copy the skill folder (skills/reorg in flonat/flonat-research) into .claude/skills/reorg in your project. Claude Code loads it when a task matches its description.

How do I install Reorg in Codex?

Run `npx skills add flonat/flonat-research --skill reorg -a codex`. Or copy the skill folder (skills/reorg in flonat/flonat-research) into .agents/skills/reorg in your project. Codex loads it when a task matches its description.

Can I use Reorg in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add flonat/flonat-research --skill reorg -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reorg, .gemini/skills/reorg, .github/skills/reorg and .opencode/skills/reorg in your project.

What does Reorg need to run?

Going by SKILL.md and its folder, Reorg needs the command-line tools its instructions call (git and ssh).

Does Reorg access the network?

SKILL.md contains no URLs. Its commands use git and ssh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Reorg safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Reorg use?

Reorg is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Reorg use?

About 989 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Reorg?

Skills that share tags, products or a category with Reorg: Question2report (refraction-ray/xalpha, 2.7k stars), Dingo Verify (MigoXLab/dingo, 757 stars), Data Validation (platonai/Browser4, 1.2k stars) and Issues Deduplication (JetBrains/ideavim, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reorg?

flonat (a GitHub user) maintains it in flonat/flonat-research, which has 145 GitHub stars. The repository holds 83 skills in this directory. The repository was last updated on September 29, 2026.

Source: flonat/flonat-research on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.