Skip to content
Back to search

editonny-local

MarketplaceWorks with Claude CodeGitHub

Local video editing through conversation. Created by Matheus Gomes.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/soumatheusgomes/editonny with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/soumatheusgomes/editonny'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/soumatheusgomes--editonny/badge.svg)](/listings/soumatheusgomes--editonny)

HTML

<a href="/listings/soumatheusgomes--editonny"><img src="/api/listings/soumatheusgomes--editonny/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You don't download anything by hand. Open **Claude Code** or **Codex** in any folder and paste this request. The same request installs editonny the first time and updates it later: your agent clones the skill from GitHub, follows its setup procedure, verifies everything, and asks before anything outside the request.

Install or update the editonny skill for Codex and Claude Code from https://github.com/soumatheusgomes/editonny. Clone the latest version into a temporary folder; I won't download anything myself. Read skills/editonny/SKILL.md and follow its complete setup procedure. If editonny is already installed, compare versions, summarize what changes, and update it through its existing delivery method: the repository installer for a shared installation (it preserves my settings and backs up the previous copy) or the host's updater for a managed plugin. Prepare the compatible local tools, locked engine, pinned renderer and browser, default transcription model, local OCR for caption checks, and bundled media before the first edit. Verify with diagnostics and a synthetic sample, report anything pending, remove the temporary clone, and tell me when to restart my agent. Ask before paid services or sending my media.

When it finishes, restart your agent and call **`/editonny` in Claude Code** or **`$editonny` in Codex**. This is the same request the guide copies for you.

| You'll need | Version | |---|---| | Claude Code or Codex | Already configured | | Python | 3.9+ for the launcher; the engine uses >=3.10,<3.14 through uv | | uv | Python manager | | FFmpeg and ffprobe | On `PATH` | | Node.js and npx | 22.13+ or 24+ | | Local OCR for caption checks | Apple Vision (macOS) or Tesseract |

The agent prepares what is missing and reports pending downloads or failed checks before calling setup complete. Local transcription and rendering do not need an LLM API key; your agent subscription is separate. External generators are optional and require your authorization before costs or media transmission.

<details> <summary><strong>Prefer the terminal?</strong></summary>

git clone https://github.com/soumatheusgomes/editonny.git
cd editonny
python3 install.py --target both
python3 ~/.local/share/editonny/scripts/editonny.py doctor
python3 ~/.local/share/editonny/scripts/editonny.py media status

Use `--target codex` or `--target claude` to register one agent. One shared installation lives at `~/.local/share/editonny`; agent entries are links to it. These commands register the skill and prepare its Python environment. For the complete setup (renderer, browser, transcription model, OCR, and synthetic checks), ask your agent to read `skills/editonny/SKILL.md` and follow its [setup procedure](skills/editonny/references/setup.md). Each use checks local readiness and GitHub updates; applying an update requires your acceptance.

See [installation and recovery](docs/installation.md) for isolated installation, plugin loading, updates, and removal.

</details>

<a id="how-it-works"></a>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 19 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "editonny-local",
  3. "owner": {
  4. "name": "Matheus Gomes",
  5. "email": "eu@matheusgom.es",
  6. "url": "https://instagram.com/matheusgomes"
  7. },
  8. "plugins": [
  9. {
  10. "name": "editonny",
  11. "source": "./",
  12. "description": "Local video editing and visual scenes",
  13. "version": "1.1.0"
  14. }
  15. ],
  16. "metadata": {
  17. "description": "Conversation-guided local video editing."
  18. }
  19. }
README.md · README · 220 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. **English** · [Português](README.pt-BR.md) · [Español](README.es.md)
  2. <a id="top"></a>
  3. <p align="center">
  4. <a href="#install"><img src="docs/assets/readme/en-US/hero.svg" alt="editonny: You ask. Your video gets rhythm. An animated workbench cuts pauses, adds captions, and applies a three-step motion scene while a playhead runs across the video, voice, caption, and motion tracks." width="100%" /></a>
  5. </p>
  6. <h1 align="center">editonny</h1>
  7. <p align="center"><strong>You ask. Your video gets rhythm.</strong></p>
  8. <p align="center">A free, open-source video editing skill for <strong>Claude Code</strong> and <strong>Codex</strong>. Cut pauses and mistakes, add captions, fix the audio, reframe, and turn parts of your speech into motion scenes by asking in plain language. Transcription and rendering run on your computer.</p>
  9. <p align="center">
  10. <a href="https://github.com/soumatheusgomes/editonny/stargazers"><img src="https://img.shields.io/github/stars/soumatheusgomes/editonny?style=flat&amp;label=Stars&amp;color=ff4f12&amp;labelColor=17171b" alt="GitHub stars" /></a>
  11. <a href="https://github.com/soumatheusgomes/editonny/actions/workflows/verify.yml"><img src="https://github.com/soumatheusgomes/editonny/actions/workflows/verify.yml/badge.svg?branch=main" alt="GitHub Actions verification" /></a>
  12. <a href="LICENSE.md"><img src="https://img.shields.io/badge/License-MIT-d4ff3a?labelColor=17171b" alt="MIT license for first-party code" /></a>
  13. <img src="https://img.shields.io/badge/Claude%20Code-skill-ff4f12?labelColor=17171b" alt="Works as a Claude Code skill" />
  14. <img src="https://img.shields.io/badge/Codex-skill-ff4f12?labelColor=17171b" alt="Works as a Codex skill" />
  15. </p>
  16. <p align="center"><a href="#install"><strong>Install with one request</strong></a> · <a href="#how-it-works">How it works</a> · <a href="#lab">Lab</a> · <a href="#motion">Motion scenes</a> · <a href="#open-the-guide">Guide</a> · <a href="#community">Star history</a></p>
  17. <p align="center"><img src="docs/assets/readme/en-US/marquee.svg" alt="Pause cutting, captions, audio, reframing, motion, 145 scenes, and 54 requests on a scrolling tape." width="100%" /></p>
  18. <a id="install"></a>
  19. ## Install with one request
  20. You don't download anything by hand. Open **Claude Code** or **Codex** in any folder and paste this request. The same request installs editonny the first time and updates it later: your agent clones the skill from GitHub, follows its setup procedure, verifies everything, and asks before anything outside the request.
  21. ```text
  22. Install or update the editonny skill for Codex and Claude Code from https://github.com/soumatheusgomes/editonny. Clone the latest version into a temporary folder; I won't download anything myself. Read skills/editonny/SKILL.md and follow its complete setup procedure. If editonny is already installed, compare versions, summarize what changes, and update it through its existing delivery method: the repository installer for a shared installation (it preserves my settings and backs up the previous copy) or the host's updater for a managed plugin. Prepare the compatible local tools, locked engine, pinned renderer and browser, default transcription model, local OCR for caption checks, and bundled media before the first edit. Verify with diagnostics and a synthetic sample, report anything pending, remove the temporary clone, and tell me when to restart my agent. Ask before paid services or sending my media.
  23. ```
  24. <p align="center"><img src="docs/assets/readme/en-US/install.svg" alt="An agent terminal receives the install request, then reports cloning the repository, reading the setup procedure, installing for both agents, preparing the engine, renderer, model, and OCR, and passing diagnostics." width="100%" /></p>
  25. When it finishes, restart your agent and call **`/editonny` in Claude Code** or **`$editonny` in Codex**. This is the same request the guide copies for you.
  26. | You'll need | Version |
  27. |---|---|
  28. | Claude Code or Codex | Already configured |
  29. | Python | 3.9+ for the launcher; the engine uses >=3.10,<3.14 through uv |
  30. | uv | Python manager |
  31. | FFmpeg and ffprobe | On `PATH` |
  32. | Node.js and npx | 22.13+ or 24+ |
  33. | Local OCR for caption checks | Apple Vision (macOS) or Tesseract |
  34. The agent prepares what is missing and reports pending downloads or failed checks before calling setup complete. Local transcription and rendering do not need an LLM API key; your agent subscription is separate. External generators are optional and require your authorization before costs or media transmission.
  35. <details>
  36. <summary><strong>Prefer the terminal?</strong></summary>
  37. ```sh
  38. git clone https://github.com/soumatheusgomes/editonny.git
  39. cd editonny
  40. python3 install.py --target both
  41. python3 ~/.local/share/editonny/scripts/editonny.py doctor
  42. python3 ~/.local/share/editonny/scripts/editonny.py media status
  43. ```
  44. Use `--target codex` or `--target claude` to register one agent. One shared installation lives at `~/.local/share/editonny`; agent entries are links to it. These commands register the skill and prepare its Python environment. For the complete setup (renderer, browser, transcription model, OCR, and synthetic checks), ask your agent to read `skills/editonny/SKILL.md` and follow its [setup procedure](skills/editonny/references/setup.md). Each use checks local readiness and GitHub updates; applying an update requires your acceptance.
  45. See [installation and recovery](docs/installation.md) for isolated installation, plugin loading, updates, and removal.
  46. </details>
  47. <a id="how-it-works"></a>
  48. ## How it works
  49. <p align="center"><img src="docs/assets/readme/en-US/workflow.svg" alt="Three steps: copy the install request, paste it into your agent, and talk to your agent." width="100%" /></p>
  50. editonny is a skill installed on your computer. You describe the result and point your agent at a video folder; the skill inspects the recording, chooses complete takes, measures cuts against the waveform, assembles a project, reviews a representative sample, and exports a checked MP4.
  51. ```text
  52. $editonny
  53. Edit a 45-second vertical video from /path/to/footage.
  54. Keep complete takes, clean pauses, breaths, and mistakes, and add clear captions.
  55. Use visual scenes only where they explain the story.
  56. Verify an 8–15 second sample before finishing the export.
  57. ```
  58. 1. Choose a goal in the guide, specify the footage folder, and copy the request (in the guide's language) to your agent.
  59. 2. The skill inspects the selected sources, proposes every editing setting, and **waits for your confirmation**, even with a detailed prompt. Defaults preserve the original image, geometry, and FPS; color filters and conversions are never automatic.
  60. 3. After acceptance, work stays in **Downloads/editonny/date-title/**: finished videos in **exports/**, editing files in **project/**. Review an **8–15 second** sample; select user approval if you want the agent to wait at this later step too.
  61. 4. A supported render route publishes uniquely named MP4/subtitle files with a matching verification manifest. Unsupported color/timing paths block clearly; remote execution must identify an accessible destination.
  62. Standard cleanup removes unnecessary pauses, audible breaths, mistakes, false starts, and redundant repetitions while preserving complete words, natural pacing, intentional pauses, and meaning. Narrow revisions stay within the requested scope. Original footage is preserved, and speech can stay in its original language.
  63. ## Every request is a layer
  64. <p align="center"><img src="docs/assets/readme/en-US/anatomy.svg" alt="An exploded isometric stack of four layers: raw footage, cut markers, captions, and a motion scene, beside their explanations." width="100%" /></p>
  65. ## Two services, one flow
  66. <p align="center"><img src="docs/assets/readme/en-US/features.svg" alt="Editor card: pause and mistake cuts, storytelling, captions, audio adjustments, and reframing. Motion card: animated lists, comparisons, numbers, diagrams, and 145 catalog scenes." width="100%" /></p>
  67. <a id="lab"></a>
  68. ## Input, request, result
  69. <p align="center"><img src="docs/assets/readme/en-US/lab.svg" alt="A transcript with marked pauses and struck mistakes switches from raw to edited, beside the input, the request, and the result." width="100%" /></p>
  70. <p align="center"><img src="docs/assets/readme/en-US/captions.svg" alt="The same caption in four lettering styles, Impact, Clean, Handwritten, and Marker, with a word-by-word highlight." width="100%" /></p>
  71. <p align="center"><img src="docs/assets/readme/en-US/framing.svg" alt="The same footage reframed through 9:16, 16:9, 1:1, and 4:5 while the subject stays centered." width="100%" /></p>
  72. <a id="motion"></a>
  73. ## Speech becomes a scene
  74. <p align="center"><img src="docs/assets/readme/en-US/motion.svg" alt="Four catalog scene motifs replaying in phone frames: three stacked steps, before and after, a number spotlight, and a question with its answer." width="100%" /></p>
  75. <p align="center"><img src="docs/assets/readme/en-US/stats.svg" alt="Free. Open. Forever. 145 motion scenes, 54 requests, and 79 bundled videos." width="100%" /></p>
  76. Scenes come from the bundled catalog of **145** motion scenes and **79** original clips; projects receive only the clips they use. Sample numbers, offers, testimonials, and brands in scenes are illustrative and must be replaced with supplied facts. Never treat generated visuals as evidence. All banners in this README are illustrative animations of the workflow, not renders of customer footage.
  77. <a id="open-the-guide"></a>
  78. ## Open the guide
  79. The guide is the editonny website: it builds editing requests, browses the 145 motion scenes and 54 example requests, and explains installation in English, Brazilian Portuguese, or Spanish (picked from your browser; your choice and your brief stay saved in that browser). It never receives or uploads footage.
  80. To run it locally from this repository (Node.js 22.13+ or 24+):
  81. ```sh
  82. npm ci
  83. python3 editonny.py guide
  84. ```
  85. This starts the development server at `http://localhost:4173` and opens it. Stop it with `Ctrl+C`; use `--port` to choose another port and `--no-open` to skip the browser. `npm run dev` does the same on port 3000.
  86. ## Structure
  87. | Path | Responsibility |
  88. |---|---|
  89. | `skills/editonny/` | Single portable skill and CLI |
  90. | `skills/editonny/engine/` | Local processing, preview, and English project template |
  91. | `skills/editonny/visuals/` | Scenes, catalog, bundled media, and recipes |
  92. | `web/` | Public guide: Next.js app with localized request builder, catalog, examples, and installation |
  93. | `DESIGN.md` | Visual contract and source of truth for design tokens |
  94. | `design-system/` | React component library, tokens, preview templates, showcase, and reference HTML |
  95. | `docs/` | Canonical architecture, installation, integration, and validation references |
  96. | `scripts/`, `tests/` | Packaging, README artwork, render checks, and regression tests |
  97. New projects use `project.json` and English commands, fields, and scene IDs. This is a clean pre-release foundation; previous experimental project formats are unsupported.
  98. <details>
  99. <summary><strong>Development, verification, and distribution</strong></summary>
  100. ## Develop and validate
  101. ```sh
  102. npm ci --ignore-scripts
  103. uv sync --locked --directory skills/editonny/engine
  104. npm run build
  105. npm run check
  106. python3 editonny.py doctor
  107. npm run test:engine
  108. npm run test:browser
  109. npm run test:preview
  110. npm run test:scenes
  111. npm run test:three
  112. python3 scripts/smoke_engine.py
  113. ```
  114. `npm run test:browser` builds the guide and runs Playwright (install its Chromium once with `npx playwright install chromium`). The preview and 3D browser checks (`npm run test:preview`, `npm run test:three`) require `agent-browser`. Render checks require FFmpeg and network access on the first HyperFrames use. Inspect generated samples before deleting task outputs from `.work/`. Full commands, results, and known limits belong in [validation](docs/validation.md).
  115. The repository is an npm workspace: `web/` (`@editonny/web`) and `design-system/` (`@editonny/design-system`). `npm run build` builds the guide; `npm run check` runs lint, typechecks, unit tests, and the icon registry check (`npm run icons` regenerates it from `design-system/assets/icons/`). Open `/design-system` on the running guide to browse every component and state in both themes; new UI follows [DESIGN.md](DESIGN.md) and [the library map](design-system/README.md).
  116. The README banners are generated from the guide's interface text and the DESIGN.md tokens: run `npm run readme:art` after changing either. `npm test` fails when a banner is stale, and the install request in each README must match the guide's.
  117. ### Deploy the guide
  118. Import the repository in Vercel and set **Root Directory** to `web`; Vercel installs the workspace from the repository root and keeps the skill's catalog available to the build. Set `NEXT_PUBLIC_SITE_URL` to the public origin (for example, a custom domain) so canonical links, `hreflang`, the sitemap, structured data, and the localized social images use it; otherwise the Vercel production domain is used.
  119. ## Package
  120. ```sh
  121. python3 scripts/package.py
  122. ```
  123. This creates the plugin ZIP with a SHA-256 file in `dist/`. It includes the canonical documentation, the complete skill, and **79 bundled videos**; projects receive only clips they use. The guide is deployed as a website instead of shipping in the archive. Building the package does not publish it or update your global installation.
  124. </details>
  125. <a id="community"></a>
  126. ## Follow the story
  127. If editonny helps your next video, give the project a star. Follow its progress, report a problem, or share an idea for a scene.
  128. <a href="https://www.star-history.com/?repos=soumatheusgomes%2Feditonny&amp;type=date">
  129. <picture>
  130. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=soumatheusgomes/editonny&amp;type=date&amp;theme=dark" />
  131. <img src="https://api.star-history.com/chart?repos=soumatheusgomes/editonny&amp;type=date" alt="Star history for soumatheusgomes/editonny" width="1000" loading="lazy" />
  132. </picture>
  133. </a>
  134. [Star the project](https://github.com/soumatheusgomes/editonny/stargazers) · [Report an issue](https://github.com/soumatheusgomes/editonny/issues) · [Open star history](https://www.star-history.com/?repos=soumatheusgomes%2Feditonny&type=date)
  135. Live star history is provided by [Star History](https://www.star-history.com/blog/how-to-use-github-star-history/) and depends on that service. The badge above shows the real GitHub star count.
  136. ## Author and contact
  137. Created and maintained by **Matheus Gomes**.
  138. - Instagram: [@matheusgomes](https://instagram.com/matheusgomes)
  139. - Email: [eu@matheusgom.es](mailto:eu@matheusgom.es)
  140. - GitHub: [soumatheusgomes/editonny](https://github.com/soumatheusgomes/editonny)
  141. ## License and resources
  142. First-party code and documentation use the [MIT License](LICENSE.md). Third-party libraries, models, fonts, audio, and media retain their own licenses and attribution; MIT does not relicense those resources. Consult the [third-party notices](skills/editonny/engine/THIRD_PARTY_NOTICES.md) and the notices beside assets before redistribution.
  143. [Product](PRODUCT.md) · [Architecture](docs/architecture.md) · [Interface](docs/design.md) · [Integrations](docs/integrations.md) · [Development setup](docs/setup.md)
  144. <p align="center"><strong>YOU HAVE THE STORY. WE GIVE IT RHYTHM.</strong><br /><a href="#top">Back to top ↑</a></p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.