SubtitleForgev1.0.0

Reads SRT and WebVTT, corrects offset and frame-rate drift from two anchor points, splits long cues at sentence and clause boundaries and merges fragments of the same sentence.

See what you can make

Made with this SkillFixed SRT and WebVTT subtitles with a review page

17 cues in, 21 readable cues out

Open full example

What you get

Fixed SRT and WebVTT subtitles with a review page

What you can make

  • Reads SRT and WebVTT, corrects offset and frame-rate drift from two anchor points, splits long cues at sentence and clause boundaries and merges fragments of the same sentence.
  • Gives each cue time to read at the profile's speed, enforces minimum and maximum durations and gaps, snaps to frames and rebalances line breaks.
  • Checks against streaming, broadcast, social and children's profiles and writes SRT, WebVTT, a transcript, a before-and-after page and, with FFmpeg, a subtitled video.
Explore delivered files6 groups
  • <name>.srt and <name>.vtt, read back and identical
  • <name>.txt transcript
  • index.html with before and after over the video
  • <name>-subtitled.mp4 with the subtitles burned in (with FFmpeg)
  • report.md with what changed and what still needs editing
  • Offline studio to edit and check as you type

Good fit

Podcasters, video editors, course creators and teams publishing interviews and social clips with captions.

Know the limits

Corrects timing and layout of existing subtitles; it does not transcribe, translate, detect shot changes or speakers, or move subtitles away from on-screen text.

About this skill

Your agent reads your SRT or WebVTT file and, from two lines you time against the video, SubtitleForge corrects both the offset and frame-rate drift. It removes stray font tags, splits cues that are too long at sentence and clause boundaries, merges fragments of the same sentence, gives every cue time to read at the profile's characters per second by using gaps and spare time from neighbours, enforces minimum and maximum durations and gaps, snaps to frames and rebalances line breaks so lines never end on words like "the" or "of". Streaming, broadcast, social and children's profiles set line length, lines and reading speed. Lines that are still spoken too fast to read are listed for your agent to condense with your approval. You get SRT and WebVTT files that read back identically, a transcript, a before-and-after page with a player over your video, a report and, with FFmpeg, a video with the subtitles burned in. Includes an offline studio. Requires Node.js 20+.

FROM PACKAGE TO FIRST RESULT

Your first result, with your agent

Choose a starting point, add the content you already have, then let your agent check the setup and create one result.

View example result

Purchase access is required. Unzip the package into the project folder below, or let your agent follow the installation guide. .agents/skills/subtitleforge

Your project name, audience and the content or images you already have are enough to start. Your agent will ask for anything essential that is missing.

3. Let your agent guide the first result

Package location: .agents/skills/subtitleforge

Use SubtitleForge to fix these subtitles: they start on time but are two seconds late by the end. Start from examples/harbour-lights.json.

Use a new output folder and preserve existing files. Inspect the actual deliverables (<name>.srt and <name>.vtt, read back and identical, <name>.txt transcript, index.html with before and after over the video), open the visual result and explain failed checks. An incomplete dependency check is not a successful result. Ask before paid services and do not publish automatically.
Before calling it done
  • Dependencies checked before rendering
  • Actual files open and work with your content
  • Editable source saved in a new folder
Made your first result? Share your experience →
Installation options & technical requirements

Start with your agent

Give this request to Claude Code, Codex or Cursor. Your agent can collect the missing details and guide your first result.

Use SubtitleForge to fix these subtitles: they start on time but are two seconds late by the end. Start from examples/harbour-lights.json.

Purchase access is required to install the package. Technical commands are available below when you need them.

US$4.99 · MIT licenseNode.js 20+ · FFmpeg with libass for burned-in video · no API keyNo API key or paid provider
  1. 01

    Choose your agent

    These steps use a project folder. Open the project in your agent and run terminal commands from its root.

    Codex directory guide

    Package folder .agents/skills/subtitleforge

  2. 02

    Add the package

    Download and unzip the package into the folder above. Keep all its files together, with SKILL.md directly inside that folder.

    Downloads require a verified account and purchase access. Choose a new folder if this Skill is already installed.

  3. 03

    Run the included sample

    Manual sample commands and technical details

    Read SKILL.md, review the generator and check its runtime requirements before running:

    cd .agents/skills/subtitleforge
    No installation needed
    node scripts/render.mjs --input examples/harbour-lights.json --subs examples/harbour-lights.srt --output ./subtitles
    Your first result

    Open index.html to compare, condense the lines listed under "Still to edit", render again and upload the .srt or .vtt.

    Harbour Lights Radio, the interview and the footage are fictional. SubtitleForge corrects timing and layout of existing subtitles; it does not transcribe or translate audio.

    If subtitles already exists, change the output to ./subtitles-2. Existing files are never overwritten.

    Prefer to ask your agent?

    Use SubtitleForge to fix my subtitles. Correct the sync and drift, give every line enough time to read, rebalance the line breaks for my platform, condense lines that are still too fast with my approval, and give me SRT, WebVTT and a review page.

Reviews

Share your first result

Tried this workflow? Help others decide with an honest review.

Before you choose this Skill

How do I get SubtitleForge?

The listed individual package price is USD 4.99. Premium downloads require a confirmed purchase or active membership. Your agent subscription, model access and external provider credits are separate.

Which agents can use this skill?

This release lists Codex, Claude Code, Cursor as intended installation hosts. Check the package’s dependencies and permissions before running it. These labels do not certify that every workflow has been tested in every agent.

What files can this workflow generate?

The documented 1.0.0 workflow lists: <name>.srt and <name>.vtt, read back and identical; <name>.txt transcript; index.html with before and after over the video; <name>-subtitled.mp4 with the subtitles burned in (with FFmpeg); report.md with what changed and what still needs editing; Offline studio to edit and check as you type. Some files or exports are optional; follow the package’s setup and inspect the delivered result.

What should I check before using the result?

Harbour Lights Radio, the interview and the footage are fictional. SubtitleForge corrects timing and layout of existing subtitles; it does not transcribe or translate audio.

$4.99One-time purchase