create-moviepilot-skill

Use this skill when the user asks to create, scaffold, update, or review a MoviePilot agent skill. This includes adding a new built-in skill under the repository `skills/` directory, editing an existing built-in skill, writing `SKILL.md` frontmatter and workflow instructions, choosing `allowed-tools`, adding helper scripts when needed, and bumping the built-in skill `version` so changes can sync into `config/agent/skills`.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

75%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 content is a well-structured, actionable, instruction-only skill body with a clear sequenced workflow and validation checklist. It scores solidly across all dimensions, with minor room to tighten redundancy and make the loader-validation step more concrete.

Suggestions

Replace the vague 'if possible, validate the file can be parsed by the MoviePilot skills loader' with a concrete, runnable validation command or a precise manual check.

Tighten redundancy between the 8-step workflow and the Final Checklist, or explicitly frame the checklist as a quick re-verification rather than restating each rule.

Add an explicit validate->fix->retry loop in Step 8 (e.g. 'if name does not match the directory, rename and re-confirm before syncing') to strengthen error recovery for destructive edits.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean, imperative, and procedural, with minor redundancy such as the Final Checklist restating points already covered in the workflow and the Step 4 frontmatter block echoing the file's own frontmatter.	4 / 5
Actionability	Provides concrete guidance via specific paths ('skills/<skill-id>/SKILL.md', 'config/agent/skills'), explicit naming/version rules, and a ready frontmatter template; the only soft spot is 'if possible, validate the file can be parsed by the MoviePilot skills loader', which is vague rather than an executable command.	4 / 5
Workflow Clarity	An 8-step sequenced workflow with a dedicated Validate step and final checklist gives clear checkpoints, but it is a one-pass checklist rather than an explicit validate->fix->retry feedback loop for the destructive file/version operations.	4 / 5
Progressive Disclosure	Well organized into clear sections (Scope, Rules, Workflow, Example, Checklist) with no nested references; appropriately self-contained for an instructions-only skill, though it exceeds the under-50-line simple-skill threshold that would warrant a 5.	4 / 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 is strong: it explicitly states both what the skill does and when to use it, lists concrete capabilities, and is tightly scoped to a distinct niche with low conflict risk. The only minor gap is slight synonym coverage in trigger terms.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions (create, scaffold, update, review; editing existing skills; writing frontmatter and workflow instructions; choosing allowed-tools; adding helper scripts; bumping version) with comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both 'what' (the enumerated skill-authoring tasks) and 'when' ('Use this skill when the user asks to create, scaffold, update, or review a MoviePilot agent skill') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes natural user-facing verbs ('create, scaffold, update, or review a MoviePilot agent skill') plus concrete nouns ('SKILL.md', 'allowed-tools', 'built-in skill'), but a few common phrasings users might say (e.g. 'add a skill', 'make a skill') are not covered.	4 / 5
Distinctiveness Conflict Risk	Scoped tightly to MoviePilot agent skill authoring with repo-specific triggers ('skills/ directory', 'config/agent/skills', 'built-in skill version'), giving it a clear niche and minimal overlap with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: jxxghp/MoviePilot
Path: skills/create-moviepilot-skill/SKILL.md
Commit: 4f716c4

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.