CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

downloader-operation

Use this skill when the user asks to inspect, diagnose, or directly control a configured qBittorrent, Transmission, or rTorrent instance. It exposes provider capabilities on demand without adding permanent Agent tools, and is suitable for task files and selection, trackers, peers, queue order, limits, tags, locations, rechecks, direct provider submissions, or batch task control.

69

Quality

87%

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

77%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.

The body is highly actionable, with executable commands, a complete typed argument contract, explicit client-resolution decision rules, and a real verification/feedback loop for writes and validation errors. Its weaknesses are structural: the action contract is fully duplicated (table plus per-action sections) and the large inline API reference makes SKILL.md monolithic rather than an overview pointing to one-level-deep reference files.

Suggestions

Remove the duplication between the action summary table and the per-action sections — keep one canonical form of the contract (e.g., the summary table plus only the rules/defaults that need elaboration).

Move the full per-action argument reference into a bundled reference file (e.g., references/actions.md) and keep a compact overview plus the fast-path rules in SKILL.md, with clearly signaled links.

Tighten the repeated guidance about not guessing or probing (the same instruction appears in the fast path, optional discovery, and contract sections) into a single statement.

DimensionReasoningScore

Conciseness

The body is mostly dense, useful reference material with no explanation of concepts Claude already knows, but the Complete Action Contract states all 26 actions twice — once in the summary table ("| `tasks.delete` | 删除任务... arguments: `task_id`, `task_ids`, `delete_files` |") and again in per-action sections — which is significant duplication that could be tightened. This sits between the score-4 anchor (only minor trimmable over-explanation) and score 2 (noticeably padded), matching "mostly efficient but could be tightened".

3 / 5

Actionability

Commands are fully executable and copy-paste ready ("python skills/downloader-operation/scripts/mp-downloader.py call --client \"main-qb\" --action tasks.list --arguments '{\"status\":\"downloading\",\"limit\":20}'"), and every action's arguments are specified with types, defaults, enums, and required markers. Specific examples cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

The workflow is clearly sequenced (resolve client → compose complete arguments → single call → verify), with an explicit Verification section ("After a write, query the smallest relevant state: `tasks.list` for status and properties, `tasks.files` for file priority") and an explicit error-recovery feedback loop ("reports all detectable argument errors in one response... correct every reported field together instead of retrying one field at a time"). Destructive and batch operations are present and verification guidance covers them, so no cap applies.

5 / 5

Progressive Disclosure

The single bundle file `scripts/mp-downloader.py` is real and correctly referenced, and section headers organize the body well, but roughly 190 lines of the 340-line body are an inline per-action API reference (the score-3 anchor's "200 lines of API reference that could be in a separate file"). No reference files exist to split detail into, and the summary table duplicates the detailed sections, leaving structure present but not well split.

3 / 5

Total

16

/

20

Passed

Description

92%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.

The description explicitly and concretely answers both what the skill does and when to use it, anchored by named provider clients and a broad enumeration of supported operations. Trigger coverage is strong but omits a few everyday phrasings (torrent, pause, seeding, magnet) users might naturally say.

Suggestions

Add one or two natural user phrasings such as "torrents" or "pause, resume, or reseed tasks" to the trigger list to broaden keyword matching.

DimensionReasoningScore

Specificity

"inspect, diagnose, or directly control a configured qBittorrent, Transmission, or rTorrent instance" plus a list of concrete capability areas ("task files and selection, trackers, peers, queue order, limits, tags, locations, rechecks, direct provider submissions, or batch task control") gives comprehensive, concrete action coverage. It exceeds the score-4 anchor, which anticipates minor gaps in coverage.

5 / 5

Completeness

An explicit "Use this skill when the user asks to inspect, diagnose, or directly control..." clause answers "when" with concrete triggers, and the enumerated operation list ("suitable for task files and selection, trackers, peers... batch task control") answers "what" concretely. Both are explicit and concrete, matching the score-5 anchor rather than score 4 where "when" is less specific.

5 / 5

Trigger Term Quality

Natural client names (qBittorrent, Transmission, rTorrent) and operation words (inspect, diagnose, recheck, tags, peers) are strong triggers, but common user phrasings like "torrents", "pause/resume", "seeding", "download speed", or "magnet" are absent. Good coverage with a few natural terms missing matches the score-4 anchor; it is below score 5, which expects synonym/extension-level comprehensiveness.

4 / 5

Distinctiveness Conflict Risk

Naming three specific torrent clients and scoping to downloader-native operation creates a clear niche with distinct triggers, minimal conflict risk. Only slight ambiguity with generic acquisition/download requests keeps it at the top anchor rather than raising overlap concerns.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

jxxghp/MoviePilot

Path

skills/downloader-operation/SKILL.md

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.