Content
88%Weight 40%Scale 1-5Reviews 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 code and well-sequenced, validated workflows for a complex domain. Its main weakness is progressive disclosure: a skill this large inlines detail that could be split into reference files, and it leans slightly long.
Suggestions
Move the detailed Vue Federation UI (backend/frontend contracts, build requirements) and Vue Federation Troubleshooting sections into separate reference files (e.g. references/vue-federation.md, references/troubleshooting.md) and link to them from SKILL.md, since the skill is large enough to benefit from one-level-deep splitting.
Consider trimming or externalizing the full implementation skeleton into a template reference file, keeping only the minimal _PluginBase contract inline in SKILL.md.
Verify the referenced ground-truth paths (app/plugins/__init__.py, app/runtime/extensions/plugin_manager.py, MoviePilot-Frontend/docs/*.md) resolve in the target repos so the signaled references are real and navigable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and assumes Claude's competence (no basic concept explanations), but the full implementation skeleton and several long inline blocks (federation config, troubleshooting) add length that could be trimmed or offloaded. Not below midpoint, just noticeably above-lean rather than perfectly efficient. | 4 / 5 |
Actionability | Provides copy-paste-ready executable code throughout: a complete _PluginBase skeleton, get_render_mode/get_sidebar_nav implementations, Vite federation config with exact exposes/shared, and concrete moviepilot_api operation_id calls with parameters. Common cases are covered with specific examples. | 5 / 5 |
Workflow Clarity | Multi-step processes are explicitly sequenced (Pre-Flight, Local Install And Reload) with validation checkpoints (plugin.market force_refresh to confirm visibility, install/reinstall with force, reload after edits) and feedback loops (reinstall when requirements.txt changes since reload alone won't install deps; fix-and-revalidate). A dedicated Validation section provides a checklist. | 5 / 5 |
Progressive Disclosure | Well-organized into clearly signaled sections with ground-truth references listed up front (Ground Truth) and navigable headings. However the skill is large (~500 lines) with no bundle files; detailed subsections like Vue Federation UI and Troubleshooting are inlined rather than split into one-level-deep reference files, leaving minor organization gaps. | 4 / 5 |
Total | 18 / 20 Passed |