Description

Get edited audio videos ready to post, without touching a single slider. Upload your audio files (MP3, WAV, AAC, M4A, up to 200MB), say something like "trim...

README (SKILL.md)

Getting Started

Got audio files to work with? Send it over and tell me what you need — I'll take care of the AI audio editing.

Try saying:

"edit a 3-minute MP3 podcast recording into a 1080p MP4"
"trim the silence at the start, boost the volume, and export as a clean audio-backed video"
"cleaning up and visualizing MP3 recordings as shareable videos for podcasters, musicians, content creators"

Automatic Setup

On first interaction, connect to the processing API before doing anything else. Show a brief status like "Setting things up...".

Token: If NEMO_TOKEN environment variable is already set, use it and skip to Session below.

Free token: Generate a UUID as client identifier, then POST to https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token with header X-Client-Id: \x3Cuuid>. The response field data.token becomes your NEMO_TOKEN (100 credits, 7-day expiry).

Session: POST to https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent with Bearer auth and body {"task_name":"project"}. Save session_id from the response.

Confirm to the user you're connected and ready. Don't print tokens or raw JSON.

MP3 Editor — Edit Audio and Export Video

Name: Mp3 Editor
Author: vcarolxhberger

Send me your audio files and describe the result you want. The AI audio editing runs on remote GPU nodes — nothing to install on your machine.

A quick example: upload a 3-minute MP3 podcast recording, type "trim the silence at the start, boost the volume, and export as a clean audio-backed video", and you'll get a 1080p MP4 back in roughly 30-60 seconds. All rendering happens server-side.

Worth noting: shorter audio clips under 2 minutes process significantly faster.

Matching Input to Actions

User prompts referencing mp3 editor, aspect ratio, text overlays, or audio tracks get routed to the corresponding action via keyword and intent classification.

User says...	Action	Skip SSE?
"export" / "导出" / "download" / "send me the video"	→ §3.5 Export	✅
"credits" / "积分" / "balance" / "余额"	→ §3.3 Credits	✅
"status" / "状态" / "show tracks"	→ §3.4 State	✅
"upload" / "上传" / user sends file	→ §3.2 Upload	✅
Everything else (generate, edit, add BGM…)	→ §3.1 SSE	❌

Cloud Render Pipeline Details

Each export job queues on a cloud GPU node that composites video layers, applies platform-spec compression (H.264, up to 1080x1920), and returns a download URL within 30-90 seconds. The session token carries render job IDs, so closing the tab before completion orphans the job.

Base URL: https://mega-api-prod.nemovideo.ai

Endpoint	Method	Purpose
`/api/tasks/me/with-session/nemo_agent`	POST	Start a new editing session. Body: `{"task_name":"project","language":"\x3Clang>"}`. Returns `session_id`.
`/run_sse`	POST	Send a user message. Body includes `app_name`, `session_id`, `new_message`. Stream response with `Accept: text/event-stream`. Timeout: 15 min.
`/api/upload-video/nemo_agent/me/\x3Csid>`	POST	Upload a file (multipart) or URL.
`/api/credits/balance/simple`	GET	Check remaining credits (`available`, `frozen`, `total`).
`/api/state/nemo_agent/me/\x3Csid>/latest`	GET	Fetch current timeline state (`draft`, `video_infos`, `generated_media`).
`/api/render/proxy/lambda`	POST	Start export. Body: `{"id":"render_\x3Cts>","sessionId":"\x3Csid>","draft":\x3Cjson>,"output":{"format":"mp4","quality":"high"}}`. Poll status every 30s.

Accepted file types: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.

Skill attribution — read from this file's YAML frontmatter at runtime:

X-Skill-Source: mp3-editor
X-Skill-Version: from frontmatter version
X-Skill-Platform: detect from install path (~/.clawhub/ → clawhub, ~/.cursor/skills/ → cursor, else unknown)

All requests must include: Authorization: Bearer \x3CNEMO_TOKEN>, X-Skill-Source, X-Skill-Version, X-Skill-Platform. Missing attribution headers will cause export to fail with 402.

Error Handling

Code	Meaning	Action
0	Success	Continue
1001	Bad/expired token	Re-auth via anonymous-token (tokens expire after 7 days)
1002	Session not found	New session §3.0
2001	No credits	Anonymous: show registration URL with `?bind=\x3Cid>` (get `\x3Cid>` from create-session or state response when needed). Registered: "Top up credits in your account"
4001	Unsupported file	Show supported formats
4002	File too large	Suggest compress/trim
400	Missing X-Client-Id	Generate Client-Id and retry (see §1)
402	Free plan export blocked	Subscription tier issue, NOT credits. "Register or upgrade your plan to unlock export."
429	Rate limit (1 token/client/7 days)	Retry in 30s once

SSE Event Handling

Event	Action
Text response	Apply GUI translation (§4), present to user
Tool call/result	Process internally, don't forward
`heartbeat` / empty `data:`	Keep waiting. Every 2 min: "⏳ Still working..."
Stream closes	Process final response

~30% of editing operations return no text in the SSE stream. When this happens: poll session state to verify the edit was applied, then summarize changes to the user.

Translating GUI Instructions

The backend responds as if there's a visual interface. Map its instructions to API calls:

"click" or "点击" → execute the action via the relevant endpoint
"open" or "打开" → query session state to get the data
"drag/drop" or "拖拽" → send the edit command through SSE
"preview in timeline" → show a text summary of current tracks
"Export" or "导出" → run the export workflow

Draft JSON uses short keys: t for tracks, tt for track type (0=video, 1=audio, 7=text), sg for segments, d for duration in ms, m for metadata.

Example timeline summary:

Timeline (3 tracks): 1. Video: city timelapse (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Title: "Urban Dreams" (0-3s)

Tips and Tricks

The backend processes faster when you're specific. Instead of "make it look better", try "trim the silence at the start, boost the volume, and export as a clean audio-backed video" — concrete instructions get better results.

Max file size is 200MB. Stick to MP3, WAV, AAC, M4A for the smoothest experience.

MP3 files under 128kbps may sound compressed — use WAV for best output quality.

Common Workflows

Quick edit: Upload → "trim the silence at the start, boost the volume, and export as a clean audio-backed video" → Download MP4. Takes 30-60 seconds for a 30-second clip.

Batch style: Upload multiple files in one session. Process them one by one with different instructions. Each gets its own render.

Iterative: Start with a rough cut, preview the result, then refine. The session keeps your timeline state so you can keep tweaking.

Usage Guidance

This skill uploads any audio you give it to an external service (mega-api-prod.nemovideo.ai) and uses a bearer token (NEMO_TOKEN) for auth; if NEMO_TOKEN is not provided it will create a short-lived anonymous token. Before installing/using: (1) confirm you trust the service and the publisher (no homepage or reputable owner listed here), (2) avoid uploading sensitive audio until you verify privacy/retention policies, (3) prefer using an account-specific token you can revoke rather than a long-lived secret stored in env, and (4) monitor or delete any saved session tokens or files in your account on the service after use. If you want higher assurance, ask the publisher for a homepage, privacy policy, and official SDK/release references for nemovideo.ai.

Capability Analysis

Type: OpenClaw Skill Name: mp3-editor Version: 1.0.0 The skill is a legitimate integration for an audio-to-video editing service hosted at nemovideo.ai. It provides clear instructions for the AI agent to manage sessions, upload media, and trigger cloud rendering via a dedicated API. Security practices are observed, such as instructions to not print raw tokens or JSON to the user, and the requested file system access is limited to its own configuration directory (~/.config/nemovideo/).

Capability Assessment

✓ Purpose & Capability

Name/description (MP3 editing and exporting MP4) aligns with the declared requirement (NEMO_TOKEN) and the SKILL.md which describes a remote render API. Required env var and config path (NEMO_TOKEN and ~/.config/nemovideo/) are plausible for a cloud video-processing integration.

ℹ Instruction Scope

SKILL.md instructs the agent to obtain/use a bearer NEMO_TOKEN (or generate an anonymous token via nemovideo API), create a session, upload user audio files, stream SSE messages, poll render status, and return a remote download URL. All of these are consistent with the stated purpose. The instructions also ask the agent to read this file's frontmatter and detect install path to populate attribution headers — this requires limited filesystem inspection. The notable runtime behavior is that user audio files and session tokens are transmitted to an external service (mega-api-prod.nemovideo.ai). This is expected for a cloud service but is the primary privacy surface to consider.

✓ Install Mechanism

No install step and no code files — instruction-only skill — so nothing is written to disk by an installer. This is the lowest install risk.

✓ Credentials

Only one required environment variable (NEMO_TOKEN) and an optional config path are declared; these are directly used for API auth and local config. No unrelated secrets or broad credential access are requested.

✓ Persistence & Privilege

always:false and normal autonomous invocation settings. The skill instructs saving session_id/tokens for operation (normal for a sessioned API) but does not request elevated or cross-skill configuration changes.

Version History

v1.0.0

MP3 Editor 1.0.0 — Initial Release - Instantly edit audio (MP3, WAV, AAC, M4A, up to 200MB) and export as 1080p MP4 video using simple instructions. - No desktop software required—processing and rendering are entirely cloud-based. - Automatic setup integrates free token management and secure session handling. - Supports direct file uploads, credit checks, export status, and timeline previews. - User commands instantly routed to upload, edit, export, or check credits/status. - Clear error handling, attribution headers, and easy-to-follow usage guidance included.

Metadata

Slug mp3-editor

Version 1.0.0

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is Mp3 Editor?

Get edited audio videos ready to post, without touching a single slider. Upload your audio files (MP3, WAV, AAC, M4A, up to 200MB), say something like "trim... It is an AI Agent Skill for Claude Code / OpenClaw, with 60 downloads so far.

How do I install Mp3 Editor?

Run "/install mp3-editor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Mp3 Editor free?

Yes, Mp3 Editor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Mp3 Editor support?

Mp3 Editor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Mp3 Editor?

It is built and maintained by vcarolxhberger (@vcarolxhberger); the current version is v1.0.0.

More Skills

Mp3 Editor