file-organizer SKILL.md skillA

file-organizer from moonlight-lupin/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add moonlight-lupin/agent-skills/file-organizer@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
moonlight-lupin/agent-skills
Path
productivity/file-organizer/SKILL.md
Versions recorded
3
Latest version
v1.0.0, committed Sep 6, 2026
First version recorded
Jul 12, 2026
Size
9,923 bytes
Repository stars
108
License
MIT

Use when the user wants to organize, tidy, or restructure a messy directory (Downloads, Desktop, documents folder). LLM-powered file organizer that scans content, proposes a structure, and executes moves in chunks with a mandatory user confirmation gate.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# File Organizer

An LLM-powered file organizer that reads file contents, proposes a sensible folder
structure with renamed files, and executes moves in chunks — with a mandatory user
confirmation gate before any filesystem changes.

## Overview

Inspired by [LlamaFS](https://github.com/iyaja/llama-fs) but designed for Hermes:
the script handles filesystem I/O (scan, read snippets, execute moves). The agent's
own LLM does the reasoning by default. An optional `propose` subcommand can call a
cheaper external LLM (deepseek, openrouter, ollama) for cost-conscious runs on large
directories. Uses stdlib-only HTTP (urllib) — no requests/openai SDK needed.

## When to Use

- User says "organize my Downloads" / "tidy my Desktop" / "clean up this folder"
- User has a messy directory and wants files sorted into categories
- User wants files renamed based on their content (not just moved)
- User wants to organize files on a local disk, network mount, or remote filesystem

**Don't use for:**
- Bulk file deletion (this skill only moves and renames, never deletes)
- Deduplication (use a dedicated dedup tool)
- File content search (use `search_files` instead)

## Workflow

### Step 1 — Scan
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add moonlight-lupin/agent-skills/file-organizer@sha256:7b7591f61684d803

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_cv3mffu4lfokong7.svg)](https://markdownregistry.com/a/art_cv3mffu4lfokong7)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Jul 12, 2026 and Sep 6, 2026, about one every 28 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-09-06 953188a 9,923 BA view · diff
v1.0.02026-08-13 090474f 9,920 BA view · diff
v1.0.02026-07-12 2a39adc 9,914 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9923 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

moonlight-lupin/agent-skills · 108 stars · license MIT · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_cv3mffu4lfokong7
GET https://markdownregistry.com/api/v1/resolve?ref=moonlight-lupin/agent-skills/file-organizer
GET https://markdownregistry.com/api/v1/blob/7b7591f61684d803fbff71defc1012cb25108764a4a77e24b473fe87056db12f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from moonlight-lupin/agent-skills

claude-plugin-converter SKILL.md skill
moonlight-lupin/agent-skills · agent-ops/claude-plugin-converter/SKILL.md · Use when converting Claude Code plugins into self-contained Hermes plugins — discovery analysis then full conversion.
v1.0.0 · audit A · 108 stars
hermes-onboarding SKILL.md skill
moonlight-lupin/agent-skills · agent-ops/hermes-onboarding/SKILL.md · Use when onboarding a new customer — configure gateway, dashboard, memory, services for production.
v1.3.0 · audit B · 108 stars
input-token-analysis SKILL.md skill
moonlight-lupin/agent-skills · agent-ops/input-token-analysis/SKILL.md · Use when input token spend needs explaining and fixing.
v1.2.0 · audit A · 108 stars
input-token-overheads SKILL.md skill
moonlight-lupin/agent-skills · agent-ops/input-token-overheads/SKILL.md · Use when context window is filling up too fast or input token cost is too high. Audits overhead sources.
v1.5.0 · audit A · 108 stars
log-analyzer SKILL.md skill
moonlight-lupin/agent-skills · agent-ops/log-analyzer/SKILL.md · Use when parsing agent log files to identify error patterns, rate limit hits, timeout clusters, tool failures, and…
v1.1.0 · audit A · 108 stars
operator-brain SKILL.md skill
moonlight-lupin/agent-skills · agent-ops/operator-brain/SKILL.md · Use when communicating, deciding, or reporting as a senior operator — 8 behavioral modules from Anthropic's Fable…
v1.1.0 · audit A · 108 stars
skill-maintainer SKILL.md skill
moonlight-lupin/agent-skills · agent-ops/skill-maintainer/SKILL.md · Use when tracking upstream drift and syncing adapted skill libraries.
v1.0.1 · audit A · 108 stars
clips-studio SKILL.md skill
moonlight-lupin/agent-skills · creative/clips-studio/SKILL.md · Use when the user wants to "make a video/clip", "generate a video from text", "animate this image/photo", "create a…
v1.2.0 · audit A · 108 stars
image-studio SKILL.md skill
moonlight-lupin/agent-skills · creative/image-studio/SKILL.md · Use when the user wants image generation or editing through the local fal.ai three-stage studio workflow — brainstorm a…
v1.2.0 · audit A · 108 stars
pexels-stock-photos SKILL.md skill
moonlight-lupin/agent-skills · creative/pexels-stock-photos/SKILL.md · Use when the user wants a REAL photo — 'find a photo of X', 'search for pictures of Y', 'stock image of Z', 'I need a…
v1.0.0 · audit A · 108 stars
disk-cleanup SKILL.md skill
moonlight-lupin/agent-skills · devops/disk-cleanup/SKILL.md · Use when df says disk is above 80% full or the user wants to reclaim storage space on a VM.
v1.3.1 · audit B · 108 stars
model-compare SKILL.md skill
moonlight-lupin/agent-skills · mlops/model-compare/SKILL.md · Blind side-by-side multi-model comparison. Send one prompt to 2-4 models simultaneously, present responses anonymously…
v1.2.0 · audit A · 108 stars

Every file in moonlight-lupin/agent-skills

Other files named file-organizer

file-organizer SKILL.md skill
nvidia/skillspector · tests/fixtures/sqp/sqp2_missing_warnings/SKILL.md · Organizes files in your project directory
git:20260512.7ced4fb · audit A · 20,539 stars
file-organizer SKILL.md skill
foryourhealth111-pixel/vibe-skills · bundled/skills/file-organizer/SKILL.md · Intelligently organizes your files and folders across your computer by understanding context, finding duplicates…
git:20260226.1632f40 · audit A · 3,758 stars
file-organizer SKILL.md skill
davepoon/buildwithclaude · plugins/all-skills/skills/file-organizer/SKILL.md · Intelligently organizes your files and folders across your computer by understanding context, finding duplicates…
git:20260104.903b22f · audit A · 3,660 stars
file-organizer SKILL.md skill
alibaba/skill-up · e2e/testdata/file-and-tool-rules/SKILL.md · Triggered when the user needs to organize project files, analyze directory structure, or generate a project report. Use…
git:20260514.47c6b4a · audit A · 1,256 stars
file-organizer SKILL.md skill
naveedharri/benai-skills · plugins/all-skills/skills/file-organizer/SKILL.md · Intelligently organizes your files and folders across your computer by understanding context, finding duplicates…
git:20260916.a3b1e15 · audit A · 71 stars
file-organizer SKILL.md skill
jjmartres/ai-coding-agents · shared/.ai-agents/skills/file-organizer/SKILL.md · Intelligently organizes your files and folders across your computer by understanding context, finding duplicates…
git:20260428.dfccef3 · audit A · 48 stars

Browse by kind, by grade A, or by owner.