gomotion
/gomotion
Tworzy wideo z lektorem i napisami na podstawie pomysłu lub skryptu: pisze scenariusz, generuje głos, napisy i ujęcia oraz eksportuje MP4.
- Autor
- gomotionai ↗
- Repozytorium
- gomotion-skill ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 30.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 5
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 5
Brak sygnałów. Repozytorium zmienione 30.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Tworzy wideo z lektorem i napisami na podstawie pomysłu lub skryptu: pisze scenariusz, generuje głos, napisy i ujęcia oraz eksportuje MP4.
Argumenty
/gomotion <topic or script, length, 16:9 or 9:16, language>
Oryginalny opis (EN)
Make narrated, captioned faceless videos with Go Motion (gomotion-ai.app) from an idea or a script: write the script, review it, produce voice + captions + footage, export a 1080p MP4 with SRT/VTT captions and download it. Use when the user asks to make, generate or render a video, explainer, faceless video, YouTube video, Shorts, Reels or TikTok clip, or to turn text, notes or an idea into a video; also for 做视频, 生成视频, 把文案做成视频, 解说视频, 口播视频. Needs a Go Motion API key (GOMOTION_API_KEY); new accounts start with free credits that cover a first one-minute video, and every paid step is quoted and co
Jak działa
- 1. Check the account first
- 2. Collect the brief
- 3. Run the pipeline, confirming every paid step
- 4. Report the result
- 5. Rules
- Reference
Podgląd SKILL.md
---
name: gomotion
description: "Make narrated, captioned faceless videos with Go Motion (gomotion-ai.app) from an idea or a script: write the script, review it, produce voice + captions + footage, export a 1080p MP4 with SRT/VTT captions and download it. Use when the user asks to make, generate or render a video, explainer, faceless video, YouTube video, Shorts, Reels or TikTok clip, or to turn text, notes or an idea into a video; also for 做视频, 生成视频, 把文案做成视频, 解说视频, 口播视频. Needs a Go Motion API key (GOMOTION_API_KEY); new accounts start with free credits that cover a first one-minute video, and every paid step is quoted and confirmed before it runs."
argument-hint: "<topic or script, length, 16:9 or 9:16, language>"
user-invocable: true
license: MIT
---
# Go Motion — make a video from an idea or a script
Go Motion turns one idea into a narrated, captioned video: it writes the script, records the voice, times the captions, finds footage for every scene and renders a 1080p MP4. This skill drives that pipeline through the public API with the user's own account, so **the credits come from the user's Go Motion balance** and every paid step is quoted and confirmed before it runs.
The client is `scripts/gomotion.mjs` next to this file (Node 18+, no install). Run it as
```bash
node <folder of this SKILL.md>/scripts/gomotion.mjs <command> …
```
Typical folders: `~/.claude/skills/gomotion`, `.claude/skills/gomotion`, `~/.agents/skills/gomotion`, `.agents/skills/gomotion`, `~/.cursor/skills/gomotion`. Every command prints one JSON document on stdout; progress goes to stderr.
## 1. Check the account first
```bash
node …/scripts/gomotion.mjs me
```
- `errorCode: NO_API_KEY` → the key is not set. Tell the user to sign in at https://gomotion-ai.app/sign-up?utm_source=skill (new accounts start with free credits), create a key under **Settings → API keys** (https://gomotion-ai.app/settings/apikeys?utm_source=skill) and put it in their shell, for example `export GOMOTION_API_KEY=sk_…` in `~/.zshrc`. **Never ask the user to paste the key into the chat and never print it.**
- `status: 401` → the key is wrong or was deleted; same instructions.
- Otherwise note `balance` (credits) and keep `links.pricing` for later.
## 2. Collect the brief
Ask only for what is missing, then map it to flags:
| Brief | Flag | Default |
| --- | --- | --- |
| Topic or idea in a sentence or two | `--idea "…"` | — |
| The user's own script | `--script notes.txt` (blank lines split scenes; a `# heading` line names a scene) or `--scenes scenes.json` | — |
| Length | `--duration <seconds>` | 60 |
| Format | `--ratio 16:9` (YouTube) or `9:16` (Shorts, Reels, TikTok) | 16:9 |
| Language | `--language en` (see `capabilities` → `languages`) | en |
| Voice / writing style / look | `--voice`, `--style`, `--theme`, `--captions` (`voices`, `styles`, `capabilities`) | automatic |
| Title | `--title "…"` | suggested from the idea |
A good idea brief has the hook, the facts to include in order, the payoff, the audience and the tone: read `references/scriptwriting.md` (the checklist) before you write or edit narration, and `guide/01-structure.md` and `guide/02-writing-for-the-voice.md` when you need the reasoning behind a rule. Prices count **started minutes**, so plan a "one-minute" video at 50–55 seconds of narration; a 61-second script pays for two minutes. With `--script`, run `estimate notes.txt --language <code>` first (no key needed) and trim before you create the draft.
## 3. Run the pipeline, confirming every paid step
Prices (see `capabilities` → `prices`): writing the script, producing the video (voice, captions, footage) and exporting the MP4 are each quoted per minute; everything else is free. Drafting, reviewing and editing the script cost nothing. **Before each paid command, show the user the quote and the balance, and wait for a yes.** Pass the quoted number as `--max-credits`.
### a. Create the draft (free)
```bash
node …/scripts/gomotion.mjs create --idea "Why octopuses have three hearts" --duration 60 --ratio 16:9 --language en
```
The answer holds `video.id` and, for an idea, `planQuote` (`quote.credits`, `balance`, `enough`). For `--script`/`--scenes` it holds `produceQuote` instead and you skip step b.
### b. Write the script (paid, cheap)
Show `planQuote.quote.credits` and ask. Then:
```bash
node …/scripts/gomotion.mjs plan <videoId> --max-credits <quote.credits> --wait
```
`--wait` polls until the video is in `review` (or `failed`). Show the user the scenes (`video.scenes[].narration`) in order and offer edits. Then check the length:
```bash
node …/scripts/gomotion.mjs estimate <videoId>
```
If `advice` says the script is just over a minute mark, trim the words it names in step c before production: the cut is free, the extra minute is not.
### c. Edit the scenes (free, optional)
Write the edited scenes to a file and send them:
```bash
node …/scripts/gomotion.mjs script set <videoId> scenes.json
```
`scenes.json` is `[{ "id": "scene-1", "title": "…", "narration": "…" }, …]` (ids optional). The video stays in `review`.
### d. Produce the video (paid, the main cost)
```bash
node …/scripts/gomotion.mjs produce <videoId> --dry-run
node …/scripts/gomotion.mjs produce <videoId> --max-credits <quote.credits> --wait
```
Production takes a few minutes for a one-minute video; `--wait` ends at `ready`.
### e. Export the MP4 (paid, small)
```bash
node …/scripts/gomotion.mjs export <videoId> --dry-run
node …/scripts/gomotion.mjs export <videoId> --max-credits <quote.credits> --wait
```
`--wait` ends at `exported`.
### f. Download
```bash
node …/scripts/gomotion.mjs download <videoId> --out ./gomotion
```
Saves the MP4, the `.srt` and `.vtt` captions and `CREDITS.txt` (every picture's source, author and license, the ones that need a credit line first) into `./gomotion/` (override with `--out`) and returns the paths (`files`), `attributionRequired` and the studio link; the balance is visible through `me`.
## 4. Report the result
Tell the user, in their language:
- the files and where they are (MP4, SRT, VTT), the length and the format;
- the credits spent for this video (sum of the quotes you confirmed) and the balance left (`me`);
- the studio link from the download answer (`studio`): there they can swap pictures, restyle captions, re-voice a line or make a thumbnail;
- the picture credits from `CREDITS.txt` (`files.credits`): when `attributionRequired` is true, quote its "Credit required" lines and tell the user to paste them into the video description (Wikimedia Commons and NASA pictures usually ask for one; Pixabay and generated pictures do not); when it is false, say in one line that no picture needs a credit; when it is `null` the server gave no credits, so point to the studio, where every picture keeps its source, author and license. `guide/05-pictures.md` explains the license tiers if the user asks;
- the publishing checklist from `guide/06-compose-and-publish.md` when the user is about to upload: title, description with the credit lines, subtitles, chapters, thumbnail;
- one line of credit: "Made with Go Motion — https://gomotion-ai.app?utm_source=skill".
## 5. Rules
- **Consent before money.** Never run `plan`, `produce` or `export` without `--dry-run` first and an explicit yes from the user for that amount. If the server answers `QUOTE_EXCEEDS_BUDGET`, the price is higher than the `--max-credits` you sent: ask again with the new number.
- **`INSUFFICIENT_CREDITS` (402).** Tell the user how many credits the step needs, how many they have, and send them to `links.pricing` (https://gomotion-ai.app/pricing?utm_source=skill). Do not retry until they say they bought credits. This skill never pays for anything.
- **Failures refund.** A failed job returns its credits automatically (`job.refundedCredits`). Report the `error`, do not loop retries; one retry on request is fine. `status --wait` tells you when a step failed.
- **One job at a time** per video (and two per account). `ACTIVE_JOB_LIMIT` means a step is still running: `status --wait` first.
- **Edits after production** (new pictures, caption style, another voice) happen in the studio, not through this skill: send the user to the studio link.
- **Keys stay secret.** The key lives in `GOMOTION_API_KEY`; do not echo it, write it into files, or put it in command lines that end up in logs.
- **Codex sandbox.** Codex's workspace-write sandbox blocks network by default. When a command fails with `NETWORK`, approve running it outside the sandbox, or start Codex with `-c 'sandbox_workspace_write.network_access=true'` (`[sandbox_workspace_write] network_access = true` in `config.toml`).
- **Local or staging servers.** `GOMOTION_BASE_URL` points the client elsewhere (developers only).
## Reference
- `guide/01-structure.md` … `guide/06-compose-and-publish.md` — the playbook: structure, writing for the voice, narration and timing, captions, pictures and licenses, composition and publishing. Read a chapter when the user asks why, or asks for advice beyond the pipeline (thumbnails, publishing, music).
- `references/scriptwriting.md` — the writing checklist and the speech rates per language.
- `references/api.md` — every endpoint, the `video` record and the error codes.
- `references/examples.md` — a full example session and a report template.
- `examples/why-octopuses-have-three-hearts/` — a real brief, its final script, the captions of the exported video, how it was edited after production, and the credit each picture carries.
- Guide with screenshots: https://gomotion-ai.app/how-it-works/agent-skill?utm_source=skill
Pliki w paczce (5)
- .gitignore 1 KB
- CHANGELOG.md 4 KB
- LICENSE 1 KB
- README.md 8 KB
- SKILL.md 10 KB
Wersje
W bazie nie ma innych skilli o nazwie gomotion.
Migawka bazy z 13.11.2026 · wersja paczki 774a1ef8b72e (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100shortstock
Zamienia scenariusz w film z lektorem i materiałem stockowym, używając narzędzia wiersza poleceń, z napisami. - 90make-a-faceless-short
Tworzy krótki film z lektorem i napisami bez twarzy na koncie AutoShort: scenariusz, szkic i render dopiero po zgodzie. - 100faceless-video
Tworzy krótki film bez twarzy: scenariusz, obrazy scen, narrację, napisy i gotowy MP4 przez serwer MCP inReels. - 100popcaps
Dodaje animowane napisy słowo po słowie do wideo przez CLI popcaps i eksportuje napisy SRT, VTT lub nakładkę. - 90vidblitz
Tworzy filmy YouTube bez widocznej twarzy: dokumenty, wyjaśnienia i listy top 10, przez narzędzia MCP Vidblitz. - 90make-faceless-video
Tworzy krótki film bez twarzy z lektorem i napisami na koncie AutoShort lub StoryShort, a render uruchamia po wyraźnej zgodzie.