CtrlK
BlogDocsLog inGet started
Tessl Logo

organize-files

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.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, highly actionable skill body with a well-sequenced workflow, explicit validation checkpoints, and a response-state feedback loop for the batch transfer operation. The only gap is the absence of full example request payloads, which keeps actionability at 4.

Suggestions

Add one or two complete example request bodies for the most common calls (e.g. a full media.recognize query and a transfer.file body) to lift actionability to copy-paste ready.

Optionally show a minimal example of inspecting data.items state values so the accepted/completed/retry_wait handling is concrete rather than descriptive.

DimensionReasoningScore

Conciseness

Lean and dense with no padding; it defines only MoviePilot-specific terms Claude would not know (e.g. 'a recording is one track, an album is one multi-track directory') and assumes general competence otherwise.

5 / 5

Actionability

Concrete guidance with named API operations, param placement (body/query/path_params), and response-state fields to inspect, but no full example request bodies make it slightly short of copy-paste ready.

4 / 5

Workflow Clarity

Clear 8-step sequence with an explicit pre-transfer confirmation checkpoint (step 6), a response-state feedback loop (accepted/retry_wait/completed/manual_review with no-resubmit guidance), and a stop-conditions checklist for the batch/destructive transfer operation.

5 / 5

Progressive Disclosure

No bundle files are needed; the single SKILL.md is well-sectioned (Workflow, Structured Calls, stop-conditions) and appropriately self-contained for a focused skill, with no nested references.

5 / 5

Total

19

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description with explicit what/when triggers and an excellent conflict-avoidance routing clause. Minor gaps in action-verb breadth and file-extension trigger terms keep specificity and trigger_term_quality just below the top anchor.

DimensionReasoningScore

Specificity

Names concrete actions ('identify and organize') across many concrete object types (video/music file, season folder, recording, album directory, mixed folder), but the verb set is limited to two actions, leaving minor coverage gaps.

4 / 5

Completeness

Explicitly answers what ('identify and organize a ... file/folder') and when ('Use this skill when the user asks MoviePilot to ...'), plus a concrete negative-routing clause for failed transfer history IDs.

5 / 5

Trigger Term Quality

Good natural-term coverage ('video/music file', 'season folder', 'recording', 'album directory', 'organize'), but file extensions users might cite (e.g. .mkv, .mp4, .flac) are absent.

4 / 5

Distinctiveness Conflict Risk

Clear MoviePilot-organize niche with distinct triggers, and the explicit routing to sibling 'transfer-failed-retry' minimizes conflict risk.

5 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository
jxxghp/MoviePilot
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.