Agent skill

Motiscope Doctor

by KumarSashank in KumarSashank/motiscope

Check and configure motiscope — verify ffmpeg/ffprobe are installed and scaffold the API-key config used for optional (stubbed) asset generation.

MITAuto-check: notesMedia & Creative

Install Motiscope Doctor

skills CLI
$ npx skills add KumarSashank/motiscope --skill motiscope-doctor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install KumarSashank/motiscope motiscope-doctor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/KumarSashank/motiscope.git skills-src && mkdir -p .claude/skills && cp -r skills-src/integrations/skills/motiscope-doctor .claude/skills/motiscope-doctor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
motiscope-doctor
GitHub stars
122
Token cost
~936 tokens
SKILL.md length
424 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Check and configure motiscope — verify ffmpeg/ffprobe are installed and scaffold the API-key config used for optional (stubbed) asset generation.

  • First-time setup
  • SKILL.md covers Running motiscope, Run status, If ffmpeg/ffprobe are missing and Scaffold config, plus 2 more sections
  • Calls codex, brew and apt-get; needs REPLICATE_API_TOKEN and FAL_KEY
  • Motiscope isnt working

What it does

Motiscope Doctor is an agent skill from KumarSashank/motiscope. Check and configure motiscope — verify ffmpeg/ffprobe are installed and scaffold the API-key config used for optional (stubbed) asset generation. Use for first-time setup, "motiscope isn't working", dependency errors, or motiscope-doctor.

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Video production, Web animation and motion and Game assets and audio. It works with FFmpeg. The repository describes itself as: Recreate any web animation from a screen recording. A motion-design plugin: analyzes motion (timing, easing, stagger, loops) and rebuilds it as GSAP / CSS / Framer Motion /… The licence is MIT.

When your agent uses it

  • First-time setup
  • Motiscope isnt working
  • Dependency errors
  • Motiscope-doctor

Example prompts

  • “motiscope isn”
  • “/motiscope-doctor”

Requirements

  • Python 3
  • A credential in GEMINI_API_KEY
  • A credential in OPENAI_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit c0ce3dd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • codex
    • brew
    • apt-get
    • dnf
    • winget
    • choco

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • REPLICATE_API_TOKEN
    • FAL_KEY
    • GEMINI_API_KEY
    • OPENAI_API_KEY
    • STABILITY_API_KEY
    • RUNWAY_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Motiscope Doctor loads about 936 tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 424 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~936

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:45
    - **Linux:** `sudo apt-get install -y ffmpeg` (or `sudo dnf install ffmpeg`)
  • NoteMentions a .env fileSKILL.md:58
    - `~/.config/motiscope/.env` (mode `0600`) — **optional** API keys for asset generation, commented out by default.
  • NoteMentions a .env fileSKILL.md:62
    write the key into `~/.config/motiscope/.env`:
  • NoteMentions a .env fileSKILL.md:72
    mmitted (the repo `.gitignore` excludes `.env`).

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from KumarSashank/motiscope at commit c0ce3dd, republished under its MIT licence (© KumarSashank). 424 words, ~936 tokens.

Download SKILL.mdSave it as .claude/skills/motiscope-doctor/SKILL.md (or your agent's skills folder).
name
motiscope-doctor
description
Check and configure motiscope — verify ffmpeg/ffprobe are installed and scaffold the API-key config used for optional (stubbed) asset generation. Use for first-time setup, "motiscope isn't working", dependency errors, or `motiscope-doctor`.

motiscope: doctor

Check and configure motiscope — verify ffmpeg/ffprobe are installed and scaffold the API-key config used for optional (stubbed) asset generation. Use for first-time setup, "motiscope isn't working", dependency errors, or motiscope-doctor.

Running motiscope

motiscope is a shell command. If it isn't found it isn't on your PATH — see https://github.com/KumarSashank/motiscope#install. The reference guides live under $(motiscope home)/references/.

Invoking the sibling skills. In Codex, mention a skill with $motiscope-recreate. In Cursor, use /motiscope-recreate. Elsewhere, just follow that skill's SKILL.md.

Seeing the frames — do not skip this. The curated keyframes are PNG files on disk, and you must actually look at them. Codex: use the view_image tool (if it's unavailable, enable tools.view_image = true in ~/.codex/config.toml, or have the user relaunch with codex -i frame1.png,frame2.png). Cursor: the file-reading tool accepts .png and puts the image in context. If you genuinely cannot open images, say so — you can still report the measured timing, but you cannot know what is animating, and you must not guess it from the filenames.

Verify dependencies and scaffold config. motiscope's pipeline is pure Python standard library, so the only hard dependencies are ffmpeg and ffprobe.

Run status

bash
motiscope doctor --json

The JSON reports status, missing_binaries, install_hint, platform, config_file, env_file, and per-provider key presence.

If ffmpeg/ffprobe are missing

Do not install silently. Ask the user for permission, then run the platform command:

  • macOS (Homebrew): brew install ffmpeg
  • Linux: sudo apt-get install -y ffmpeg (or sudo dnf install ffmpeg)
  • Windows: winget install Gyan.FFmpeg (or choco install ffmpeg)

Re-run mvsetup.py --check afterward to confirm (exit 0 = ready).

Show full SKILL.md (172 more words)Show less

Scaffold config

bash
motiscope doctor

This creates, if absent:

  • ~/.config/motiscope/config.json — non-secret preferences (default_target, frame_budget, resolution, frame_format, image_provider, video_provider).
  • ~/.config/motiscope/.env (mode 0600) — optional API keys for asset generation, commented out by default.

API keys (optional)

Asset generation (creating an image an animation needs) is optional — no key is required for analysis or code recreation. Image generation is real for Gemini/Imagen; the other providers write a labeled placeholder until wired. To configure one, ask the user which provider, and write the key into ~/.config/motiscope/.env:

PurposeProviders (env var)
ImageGemini/Imagen (GEMINI_API_KEY) — implemented; OpenAI (OPENAI_API_KEY), Stability (STABILITY_API_KEY), Replicate (REPLICATE_API_TOKEN), fal (FAL_KEY)
VideoRunway (RUNWAY_API_KEY), Replicate (REPLICATE_API_TOKEN), fal (FAL_KEY)

Image generation works today with gemini (Imagen). Other providers write a labeled placeholder until wired.

Reassure the user: keys stay in a local 0600 file, are never printed, never written into generated code, and never committed (the repo .gitignore excludes .env).

Report back

Summarize: dependency status, what was scaffolded, and whether any provider keys are configured. If everything is ready, say so in one line and point them at motiscope-analyze.

© KumarSashank, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in integrations/skills/motiscope-doctor of KumarSashank/motiscope.

Open the folder on GitHubat commit c0ce3dd

Compare with similar skills

Motiscope Doctor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Motiscope Doctor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Motiscope Doctor this skillKumarSashank/motiscope122—~936Automated safety check: NotesMIT
HyperFrames Video Compositionsspinabot/brigade11k—~1.6kAutomated safety check: PassMIT
Motion Adfabricioctelles/skills106—~4.1kAutomated safety check: PassApache-2.0
Remotion Video Enhanceranbeime/skill7.8k—~1.9kAutomated safety check: NotesNone
Vid Sizzle ReelVarnan-Tech/opendirectory674—~3.9kAutomated safety check: PassMIT
HyperFrames Animationheygen-com/hyperframes60k3 repos~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • Writes HTML compositions with a GSAP timeline that the render_video tool turns into deterministic MP4 videos from data, text or layouts.

    11k GitHub stars~1.6k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Motion Ad

    fabricioctelles/skills

    Produce a short motion-graphics video ad — a 15s Facebook/Instagram/TikTok spot — as a rendered MP4.

    106 GitHub stars~4.1k tokensUpdated today
    Media & CreativeAuto-check passed
  • Adds Remotion-style video transitions and Framer Motion page animations to PPT-based videos and HTML slide viewers, planning the animation sequence first.

    7.8k GitHub stars~1.9k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Vid Sizzle Reel

    Varnan-Tech/opendirectory

    Generates a high-energy sizzle reel or hype video (MP4) from brand assets and key messages.

    674 GitHub stars~3.9k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • HyperFrames Animation

    heygen-com/hyperframes

    Collects motion rules, scene blueprints, transitions and runtime adapters for HyperFrames video compositions, with GSAP as the default animation runtime.

    60k GitHub starsUsed in 3 repos~2.1k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    60k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed

More from KumarSashank/motiscope

All 8 skills in this repo
  • Analyze

    KumarSashank/motiscope

    Analyze a screen recording of an animation to characterize its motion — timing, easing, transforms, and sequencing — so it can be recreated as web code.

    122 GitHub stars~3.1k tokensUpdated 2 mo ago
    Auto-check: notes
  • Doctor

    KumarSashank/motiscope

    Check and configure motiscope — verify ffmpeg/ffprobe are installed and scaffold the API-key config used for optional (stubbed) asset generation.

    122 GitHub stars~736 tokensUpdated 2 mo ago
    Auto-check: notes
  • Motiscope Analyze

    KumarSashank/motiscope

    Analyze a screen recording of an animation to characterize its motion — timing, easing, transforms, and sequencing — so it can be recreated as web code.

    122 GitHub stars~3.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Motiscope Rebuild Site

    KumarSashank/motiscope

    Rebuild a whole landing page / multi-section website from a screen recording that scrolls or walks through it.

    122 GitHub stars~2.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Motiscope Recreate

    KumarSashank/motiscope

    Recreate an analyzed animation as working web code — GSAP (JavaScript), CSS/Web Animations, Framer Motion (React), or Lottie/SVG.

    122 GitHub stars~2k tokensUpdated 2 mo ago
    Auto-check passed
  • Rebuild Site

    KumarSashank/motiscope

    Rebuild a whole landing page / multi-section website from a screen recording that scrolls or walks through it.

    122 GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check: notes

Works with

Questions about Motiscope Doctor

What does Motiscope Doctor do?

Check and configure motiscope — verify ffmpeg/ffprobe are installed and scaffold the API-key config used for optional (stubbed) asset generation. Motiscope Doctor is an agent skill from KumarSashank/motiscope. Check and configure motiscope — verify ffmpeg/ffprobe are installed and scaffold the API-key config used for optional (stubbed) asset generation.

When should I use Motiscope Doctor?

Motiscope Doctor fits situations like: first-time setup; motiscope isnt working; dependency errors; motiscope-doctor.

How do I install Motiscope Doctor in Claude Code?

Run `npx skills add KumarSashank/motiscope --skill motiscope-doctor -a claude-code`. Or copy the skill folder (integrations/skills/motiscope-doctor in KumarSashank/motiscope) into .claude/skills/motiscope-doctor in your project. Claude Code loads it when a task matches its description.

How do I install Motiscope Doctor in Codex?

Run `npx skills add KumarSashank/motiscope --skill motiscope-doctor -a codex`. Or copy the skill folder (integrations/skills/motiscope-doctor in KumarSashank/motiscope) into .agents/skills/motiscope-doctor in your project. Codex loads it when a task matches its description.

Can I use Motiscope Doctor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add KumarSashank/motiscope --skill motiscope-doctor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/motiscope-doctor, .gemini/skills/motiscope-doctor, .github/skills/motiscope-doctor and .opencode/skills/motiscope-doctor in your project.

What does Motiscope Doctor need to run?

Going by SKILL.md and its folder, Motiscope Doctor needs the command-line tools its instructions call (codex, brew, apt-get, dnf, winget and choco) and credentials named REPLICATE_API_TOKEN, FAL_KEY, GEMINI_API_KEY and OPENAI_API_KEY. Our summary lists: Python 3; A credential in GEMINI_API_KEY; A credential in OPENAI_API_KEY.

Does Motiscope Doctor access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Motiscope Doctor safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo; mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Motiscope Doctor use?

Motiscope Doctor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Motiscope Doctor use?

About 936 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Motiscope Doctor?

Skills that share tags, products or a category with Motiscope Doctor: HyperFrames Video Compositions (spinabot/brigade, 11k stars), Motion Ad (fabricioctelles/skills, 106 stars), Remotion Video Enhancer (anbeime/skill, 7.8k stars) and Vid Sizzle Reel (Varnan-Tech/opendirectory, 674 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Motiscope Doctor?

KumarSashank (a GitHub user) maintains it in KumarSashank/motiscope, which has 122 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on July 28, 2026.

Source: KumarSashank/motiscope on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.