FilmoTvor.AI

Power tools

Audit your own skill: how /skill-reviewer scores and tightens your SKILL.md

6 min readAdvanced/skill-reviewer
Film Movie StudioRender
Bakery ordering appNew project
Search skills…
AllWorkflowsQuick
video
Short DramaViral vertical mini-series, end to end.
image
Image CreatorGenerate single images from a prompt.
audio
Audio StudioVoiceover, SFX and music tracks.
copy
App BuilderMulti-screen apps with live preview.
image
E-commerce DesignPro product shots for any platform.
video
Music VideoBeat-synced clips cut to your track.

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. 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 StudioRender
    Bakery ordering appNew project
    Search skills…
    AllWorkflowsQuick
    video
    Short DramaViral vertical mini-series, end to end.
    image
    Image CreatorGenerate single images from a prompt.
    audio
    Audio StudioVoiceover, SFX and music tracks.
    copy
    App BuilderMulti-screen apps with live preview.
    image
    E-commerce DesignPro product shots for any platform.
    video
    Music 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. 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 StudioRender
    Bakery ordering appNew project
    60%
    prompt
    frame_01.png
    Generating… 42%
    Remix
    frame_02.png
    Generating… 68%
    Remix
    frame_03.png
    Generating… 55%
    Remix
    frame_04.png
    Generating… 80%
    Remix
    output
    Tip: Always include the frontmatter. A missing slug breaks slash dispatch, and the auditor needs to see it.
  3. 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 StudioRender
    Bakery ordering appNew project
    60%
    prompt
    frame_01.png
    Generating… 42%
    Remix
    frame_02.png
    Generating… 68%
    Remix
    frame_03.png
    Generating… 55%
    Remix
    frame_04.png
    Generating… 80%
    Remix
    output
  4. 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 StudioRender
    Bakery ordering appNew project
    Final render1080p · MP4
    SaveFiles
  5. 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 StudioRender
    Bakery ordering appNew project

    Drag 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. 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 StudioRender
    Bakery ordering appNew project

    Drag an image here, or click to upload

    reference.png
  7. 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 StudioRender
    Bakery ordering appNew project
    60%
    prompt
    frame_01.png
    Remix
    frame_02.png
    Remix
    frame_03.png
    Remix
    frame_04.png
    Generating… 80%
    Remix
    output
  8. 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 StudioRender
    Bakery ordering appNew project

    Drag 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