New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Organize Files

by jxxghp in jxxghp/MoviePilot

A skill your agent uses when the user asks MoviePilot to identify and organize a local or downloaded video/music file, season folder, recording, album directory, or mixed folder that automatic…

GPL-3.0Auto-check passedProductivity & Automation

Install Organize Files

skills CLI
$ npx skills add jxxghp/MoviePilot --skill organize-files -a claude-code

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

GitHub CLI
$ gh skill install jxxghp/MoviePilot organize-files --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/jxxghp/MoviePilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/organize-files .claude/skills/organize-files && 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
organize-files
GitHub stars
12k
Token cost
~965 tokens
SKILL.md length
427 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
GPL-3.0

At a glance

A skill your agent uses when the user asks MoviePilot to identify and organize a local or downloaded video/music file, season folder, recording, album directory, or mixed folder that automatic…

  • Works in 8 steps: Establish scope. If the user provides a… → Classify files into movie, TV, one music… → Call media.recognize with the… → …
  • The user asks MoviePilot to identify and organize a local
  • SKILL.md covers Workflow and Structured Calls
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Organize Files is an agent skill from jxxghp/MoviePilot. Use this skill when the user asks MoviePilot to identify and organize a local or downloaded video/music file, season folder, recording, album directory, or mixed folder that automatic transfer did not handle. If failed transfer history IDs are supplied, use transfer-failed-retry instead.

Its SKILL.md is about 970 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 Productivity & Automation, covering File organization. The licence is GPL-3.0.

When your agent uses it

  • The user asks MoviePilot to identify and organize a local
  • Downloaded video/music file
  • Album directory
  • Mixed folder that automatic transfer did not handle

Example prompts

  • “/organize-files”

Requirements

  • Pre-approved tools (allowed-tools): moviepilot_api, execute_command, ask_user_choice, send_message

Workflow steps

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

  1. Establish scope. If the user provides a path, use it. If they identify a
  2. Classify files into movie, TV, one music recording, one complete album,
  3. Call media.recognize with the representative title or path. If uncertain,
  4. Preserve the exact media_source + media_id. For TV, verify season detail
  5. When duplicate risk matters, call library.exists. If an existing transfer
  6. Before a state-changing transfer, summarize the source, target identity,
  7. Call transfer.file once per verified unit. For an album, transfer the album
  8. If requested, call media.scrape after a successful transfer. Report actual

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • moviepilot_api
    • execute_command
    • ask_user_choice
    • send_message

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Organize Files loads about 965 tokens when it runs. Until then it costs about 76 tokens; SKILL.md has 427 words of instructions outside code blocks.

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

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 jxxghp/MoviePilot at commit 28e1cb3, republished under its GPL-3.0 licence (© jxxghp). 427 words, ~965 tokens.

Download SKILL.mdSave it as .claude/skills/organize-files/SKILL.md (or your agent's skills folder).
name
organize-files
description
Use this skill when the user asks MoviePilot to identify and organize a local or downloaded video/music file, season folder, recording, album directory, or mixed folder that automatic transfer did not handle. If failed transfer history IDs are supplied, use transfer-failed-retry instead.
allowed-tools
moviepilot_api, execute_command, ask_user_choice, send_message
version
5
allowed-api-operations
storage.settings storage.list transfer.history transfer.history.delete media.recognize media.search media.detail library.exists transfer.file media.scrape

Organize Files

Use moviepilot_api for every MoviePilot business operation. Retired file, recognition, transfer, and history tools are not available.

Workflow

  1. Establish scope. If the user provides a path, use it. If they identify a downloader task, use downloader-operation and its fixed scripts/mp-downloader.py helper to discover the instance and call tasks.list. If they only name a configured root, call storage.settings. Use storage.list to inspect the selected directory. Do not process a broad shared root without an explicit, bounded scope.
  2. Classify files into movie, TV, one music recording, one complete album, subtitle/sidecar, or unrelated content. Do not group unrelated media merely because they share a directory.
  3. Call media.recognize with the representative title or path. If uncertain, call media.search; if several exact candidates remain, use ask_user_choice. Never invent or translate an ID.
  4. Preserve the exact media_source + media_id. For TV, verify season detail with media.detail when numbering is ambiguous. For music, a recording is one track, an album is one multi-track directory, and an artist is browse-only.
  5. When duplicate risk matters, call library.exists. If an existing transfer record affects reorganization, inspect transfer.history.
  6. Before a state-changing transfer, summarize the source, target identity, media type, season/music entity, storage, and mode. Continue only when the user's request already authorizes that exact action or after confirmation.
  7. Call transfer.file once per verified unit. For an album, transfer the album directory once only after its supported audio-file count is consistent with the selected album detail.
  8. If requested, call media.scrape after a successful transfer. Report actual tag, cover, and lyrics counts; never assume all lyrics were found.
Show full SKILL.md (163 more words)Show less

Structured Calls

  • Directory listing: storage.list with storage/path/paging/sort in body.
  • Recognition: media.recognize with title/path in query.
  • Search: media.search with title/type/source constraints in query.
  • Detail: media.detail with path_params.media_id and identity/type in query.
  • Library check: library.exists with the exact identity in query.
  • Transfer: transfer.file with the manual-transfer request in body.
  • Actual transfer responses include data.items even when the batch reports failure. Inspect every item's state: accepted and retry_wait mean that background work remains; only completed confirms execution and settlement. manual_review requires resolving the task in the transfer queue first; failed and skipped do not mean imported. Do not resubmit an entire batch that already contains accepted or completed items. Preview responses remain planning data and do not contain execution states.
  • Scrape: media.scrape with path_params.storage, file item in body, and exact identity/type fields in query.

Stop and report instead of transferring when the source is missing, directory configuration is absent, identity remains ambiguous, an album appears mixed or incomplete, or the requested target would overwrite unrelated media.

© jxxghp, GPL-3.0. 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/organize-files of jxxghp/MoviePilot.

Open the folder on GitHubat commit 28e1cb3

Compare with similar skills

Organize Files 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.

Organize Files compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Organize Files this skilljxxghp/MoviePilot12k—~965Automated safety check: PassGPL-3.0
Abp App Nolayersabpframework/abp14k—~575Automated safety check: PassLGPL-3.0
Feishu Driveraucvr/Group-Goki1123 repos~587Automated safety check: PassMIT
Azldev Comp Tomlmicrosoft/azurelinux5.3k—~1.8kAutomated safety check: PassMIT
Answer Me With HTMLOWWZO/ai-agent1891 repos~4.1kAutomated safety check: PassMIT
PikpakBengerthelorf/pikpaktui121—~1.2kAutomated safety check: PassApache-2.0

Similar skills

  • Abp App Nolayers

    abpframework/abp

    ABP Single-Layer (No-Layers / nolayers) application template - single project structure, feature-based file organization, no separate Domain/Application.Contracts projects.

    14k GitHub stars~575 tokensUpdated yesterday
    Productivity & AutomationAuto-check passed

  • Feishu Drive

    raucvr/Group-Goki

    Feishu cloud storage file management. An agent skill from raucvr/Group-Goki.

    112 GitHub starsUsed in 3 repos~587 tokens
    Productivity & AutomationAuto-check passed

  • Azldev Comp Toml

    microsoft/azurelinux

    Official

    Read this before authoring, editing, or reviewing a .comp.toml file; do not work from memory.

    5.3k GitHub stars~1.8k tokensUpdated today
    Productivity & AutomationAuto-check passed

  • Answer Me With HTML

    OWWZO/ai-agent

    Turns an answer into a one-page visual HTML explainer: the model writes a short Markdown draft and the bundled CLI builds one page.

    189 GitHub starsUsed in 1 repo~4.1k tokens
    Productivity & AutomationAuto-check passed

  • Pikpak

    Bengerthelorf/pikpaktui

    Manage PikPak cloud storage — browse, upload, download, stream, share, and organize files via CLI.

    121 GitHub stars~1.2k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed

  • Advanced File Management

    MassLab-SII/open-agent-skills

    Advanced file management tools. An agent skill from MassLab-SII/open-agent-skills.

    133 GitHub stars~1.6k tokensUpdated 9 mo ago
    Productivity & AutomationAuto-check passed

More from jxxghp/MoviePilot

All 16 skills in this repo

  • MoviePilot Downloader Operation

    jxxghp/MoviePilot

    Inspects, diagnoses and directly controls qBittorrent, Transmission or rTorrent downloaders configured in MoviePilot through a bundled Python helper.

    12k GitHub stars~4.4k tokensUpdated today
    Auto-check passed

  • MoviePilot Feedback Issue Filer

    jxxghp/MoviePilot

    Turns a confirmed MoviePilot bug or feature request into a structured upstream GitHub issue, but only after local diagnosis and an explicit request to file.

    12k GitHub stars~2.9k tokensUpdated today
    Auto-check passed

  • MoviePilot Media Server Operations

    jxxghp/MoviePilot

    Inspects and operates Emby, Jellyfin, Plex and other media servers configured in MoviePilot through one helper script, without exposing stored credentials.

    12k GitHub stars~3.4k tokensUpdated today
    Auto-check passed

  • Publish MoviePilot Plugin

    jxxghp/MoviePilot

    Publishes and syncs a local MoviePilot plugin to a GitHub repository, merging only that plugin's package entry and previewing differences before writing.

    12k GitHub stars~1.9k tokensUpdated today
    Auto-check: notes

  • GitHub Fork and PR Submission

    jxxghp/MoviePilot

    Submits code changes as a GitHub pull request through an isolated Git clone, reusing or creating your fork and pushing only after you confirm the real diff.

    12k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes

  • AnySearch

    jxxghp/MoviePilot

    Gives your agent a real-time search service for web queries, domain-specific lookups, parallel batch searches and full-page URL extraction.

    12k GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: notes

Categories

Questions about Organize Files

What does Organize Files do?

A skill your agent uses when the user asks MoviePilot to identify and organize a local or downloaded video/music file, season folder, recording, album directory, or mixed folder that automatic…. Organize Files is an agent skill from jxxghp/MoviePilot. Use this skill when the user asks MoviePilot to identify and organize a local or downloaded video/music file, season folder, recording, album directory, or mixed folder that automatic transfer did not handle.

When should I use Organize Files?

Organize Files fits situations like: the user asks MoviePilot to identify and organize a local; downloaded video/music file; album directory; mixed folder that automatic transfer did not handle.

How do I install Organize Files in Claude Code?

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

How do I install Organize Files in Codex?

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

Can I use Organize Files 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 jxxghp/MoviePilot --skill organize-files -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/organize-files, .gemini/skills/organize-files, .github/skills/organize-files and .opencode/skills/organize-files in your project.

What does Organize Files need to run?

SKILL.md names no scripts, command-line tools or credentials: Organize Files is instructions for the agent only. Its frontmatter pre-approves these tools: moviepilot_api, execute_command, ask_user_choice, send_message.

Does Organize Files access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Organize Files 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 Organize Files use?

Organize Files is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Organize Files use?

About 965 tokens (SKILL.md is roughly 3.9k 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 Organize Files?

Skills that share tags, products or a category with Organize Files: Abp App Nolayers (abpframework/abp, 14k stars), Feishu Drive (raucvr/Group-Goki, 112 stars), Azldev Comp Toml (microsoft/azurelinux, 5.3k stars) and Answer Me With HTML (OWWZO/ai-agent, 189 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Organize Files?

jxxghp (a GitHub user) maintains it in jxxghp/MoviePilot, which has 11,861 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 11, 2026.

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