mcpField
S
subtitle-packager

subtitle-packager

github.com/postplusaiCreative & media271.0k installsUpdated 1d ago
Repository

About subtitle-packager

subtitle-packager is a PostPlus skill for turning an existing, stably timed transcript into subtitle files and editor handoff materials. It packages transcripts rather than performing speech recognition or video analysis.

Key features

  1. 01Chunks transcripts for readable captions
  2. 02Generates SRT and ASS files
  3. 03Preserves transcript source and subtitle settings
  4. 04Provides editor handoff files

Use cases

  1. 01Packaging a timed transcript as subtitles
  2. 02Preparing captions for an editor handoff

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/postplusai/postplus-skills --skill subtitle-packager

After installing, type/subtitle-packagerin Claude Code to confirm it loaded.

Details

From the project README

Subtitle Packager

Use When

  • A stable timed transcript already exists and the job is subtitle chunking, SRT/ASS generation, readable caption packaging, or editor handoff.
  • This skill packages transcripts. It must not call speech-to-text or video analysis models.

Do Not Use When

  • The task belongs to ideation, QA, or another released skill listed in the handoff section.
  • Required inputs are missing and guessing would change the result.

Input Boundary

  • Primary input is normalized-transcript.json from audio-transcription or video-transcription with stable timing.
  • If timing is missing or invalid, stop and say so plainly. Do not invent timing unless the user explicitly asks for heuristic timing.
  • Preserve source transcript path, subtitle mode, output path, and source basis in handoff notes or intermediate JSON.

Path And Handoff

  • Keep chunking inputs, intermediate subtitle JSON, and render artifacts under .postplus/subtitle-packager when they are internal state.
  • Keep final user-facing .srt, .ass, and editor handoff files outside .postplus.
  • Start with one normalized transcript before broader batch packaging.
  • Return final subtitle paths, source transcript path, selected chunk mode, and any profile path used.

Stop Conditions

  • Stop when required user intent, source evidence, or owned input artifacts are missing and guessing would change the result.
  • If an owned CLI or script command still fails after any bounded recovery allowed by the executing PostPlus skill, report the exact error and stop. Do not bypass the failure with metadata-only answers, readiness probing, local payload rewrites, fallback providers, or unpublished tools.

Public Command Boundary

  • Choose the smallest matching command or workflow from the user input and run it directly.
  • If an owned CLI or script command still fails after any bounded recovery allowed by the executing PostPlus skill, report the exact error and stop. Do not bypass the failure with metadata-only answers, readiness probing, local payload rewrites, fallback providers, or unpublished tools.

Comments

Markdown supported