Once you've written a custom skill with /skill-creator, the next question is: is it actually good? /skill-reviewer is a read-only auditor — it never edits or installs your SKILL.md, it just reads it and scores it across five dimensions (frontmatter, tool correctness, self-containment, flow design, safety and honesty). The most common silent bug: a skill references a tool that doesn't exist in the app's catalog, so it only fails at runtime. This guide is for power users and pairs with /skill-creator: write, audit, fix, repeat.
What you'll need
- FilmMovie Studio with at least one provider configured for text generation (generate_copy).
- A finished SKILL.md you want to audit — ideally written with /skill-creator.
- Basic familiarity with skill conventions: frontmatter, the tool catalog and the self-containment rule.
Step by step
- 1
Launch /skill-reviewer from the skills hub
In the chat panel, open the skills hub and pick /skill-reviewer. The hub shows its card described as a "read-only SKILL.md audit". Click it to activate it for the current project — no setup needed.
Film Movie StudioRenderBakery ordering appNew projectSearch skills…AllWorkflowsQuickvideoShort DramaViral vertical mini-series, end to end.imageImage CreatorGenerate single images from a prompt.audioAudio StudioVoiceover, SFX and music tracks.copyApp BuilderMulti-screen apps with live preview.imageE-commerce DesignPro product shots for any platform.videoMusic VideoBeat-synced clips cut to your track.Tip: The auditor is strictly read-only: it never edits or installs anything. You can safely hand it a production skill. - 2
Paste the full SKILL.md content
The auditor can only score text it can see. If you just name an installed skill, it uses ask_user_text to request the content. Copy the entire SKILL.md, including the frontmatter between the --- fences, and paste it into chat.
Film Movie StudioRenderBakery ordering appNew projectFiles
frame_1.png
frame_2.png
frame_3.png
frame_4.png
frame_5.png60%promptframe_01.png
Generating… 42%Remixframe_02.png
Generating… 68%Remixframe_03.png
Generating… 55%Remixframe_04.png
Generating… 80%RemixoutputTip: Always include the frontmatter. A missing slug breaks slash dispatch, and the auditor needs to see it. - 3
Let it score the five dimensions
The auditor reads the SKILL.md and (optionally via generate_copy) extracts every tool name mentioned. It then scores five dimensions 0–10: frontmatter, tool correctness, self-containment, flow design and safety/honesty, and computes an overall score to one decimal.
Film Movie StudioRenderBakery ordering appNew projectFiles
frame_1.png
frame_2.png
frame_3.png
frame_4.png
frame_5.png
frame_6.png60%promptframe_01.png
Generating… 42%Remixframe_02.png
Generating… 68%Remixframe_03.png
Generating… 55%Remixframe_04.png
Generating… 80%Remixoutput - 4
Catch critical tool bugs
The dimension that matters most is tool correctness: every reference must exist in the app's catalog (generate_image, generate_video, generate_audio, generate_copy, render_timeline and the like). Any invented name ("editing agent", external search) is a critical finding — the skill would fail at runtime, and the overall score can't exceed 5.
Film Movie StudioRenderBakery ordering appNew projectFiles
frame_1.png
frame_2.png
frame_3.pngFinal render1080p · MP4
SaveFiles - 5
Read the review card on the canvas
The auditor drops the full review on the canvas as a "document" card named "Skill review — <slug>" and posts a three-line summary in chat. The card has a score per dimension with a one-line justification and exact quotes from your text.
Film Movie StudioRenderBakery ordering appNew projectFiles
frame_1.png
frame_2.png
frame_3.png
frame_4.pngDrag an image here, or click to upload
reference.png
Tip: For every finding the auditor quotes your own sentence, so you know exactly which line to fix. - 6
Triage findings: Critical / Important / Nice-to-have
The review sorts fixes into three buckets. Start with Critical (especially non-existent tools and a missing slug), then Important (over-asking via ask_user_*, render_timeline called more than once, prompts not in English) and finally Nice-to-have.
Film Movie StudioRenderBakery ordering appNew projectFiles
frame_1.png
frame_2.png
frame_3.png
frame_4.png
frame_5.pngDrag an image here, or click to upload
reference.png
- 7
Request a corrected block or section rewrite
At the end, the auditor offers next steps via ask_user_choice: "show a corrected frontmatter block", "rewrite the worst section" or "done". It prints the corrected text straight into chat — still without changing anything in your file.
Film Movie StudioRenderBakery ordering appNew projectFiles
frame_1.png
frame_2.png
frame_3.png
frame_4.png
frame_5.png
frame_6.png60%promptframe_01.png
Remixframe_02.png
Remixframe_03.png
Remixframe_04.png
Generating… 80%Remixoutput - 8
Return to /skill-creator and apply the fixes
Copy the corrected frontmatter or rewritten section back into your skill via /skill-creator, save, and run /skill-reviewer again. Repeat the write → audit → fix loop until all Critical and Important findings are gone.
Film Movie StudioRenderBakery ordering appNew projectFiles
frame_1.png
frame_2.png
frame_3.pngDrag an image here, or click to upload
reference.png
Tip: The goal isn't a perfect 10 — it's zero critical findings and a clean run in a real project.
What you get
You have an objective, quote-backed review of your skill saved as a canvas card: scores across five dimensions, prioritized findings and concrete fixes. Together with /skill-creator this forms a solid working loop — write, audit, fix — that keeps your skills running reliably and free of references to non-existent tools.
Pro tips
- The audit doesn't judge artistic intent, it judges reliability: the goal is an error-free run, not prettier prompts.
- A skill that references a tool outside the catalog can never score above 5 — fix that first.
- The runtime loads only the SKILL.md itself, so any reference to external files or URLs is a finding — inline load-bearing tables directly into the text.
Try it yourself
FilmMovie Studio is a desktop app that walks you from idea to finished export. Download it and start creating.
Get FilmMovie Studio