How do I install the Build Subtitles skill?

Run npx skillmds@latest add leedonwoo2827-ship-it/build-subtitles in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Build Subtitles safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Build Subtitles?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Build Subtitles free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Build Subtitles?

leedonwoo2827-ship-it (@leedonwoo2827-ship-it) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Build Subtitles by leedonwoo2827-ship-it

Name: Build Subtitles
Author: leedonwoo2827-ship-it

Build Subtitles

workspace/ch{NN}/script.json의 scenes[].narration_text를 한국어 SRT 자막으로 변환한다. 문장 단위 분절, narration_seconds 기반 타이밍 계산, UTF-8 BOM + CRLF 인코딩, 줄 길이·큐 길이 규칙 검증을 수행하고 편집 권장 목록을 제시한다. 씬별 SRT + 합본 SRT를 저장한다. 사용자가 "자막 만들어줘", "SRT 생성", "/weave-subtitle"라고 요청하면 이 스킬을 사용한다.

File contents

자막 생성 (Build Subtitles)

내레이션 텍스트를 CapCut 호환 SRT 자막 파일로 변환한다. 사람이 최종 검수·수정할 것을 전제로 한다.

사전 조건

workspace/ch{NN}/script.json 이 존재해야 함 (/weave-ingest 선행)
knowledge/subtitle-style-guide.md 의 규칙을 따른다

처리 단계

script.json 로드: scenes[] 의 narration_text 와 narration_seconds 수집.
문장 분절: ., ?, !, 。 경계로 1차 분할. 긴 문장은 접속사 경계에서 2차 분할.
타이밍 계산: 씬 내 각 큐 지속 시간 = (cue_chars / scene_chars) × narration_seconds. 씬 간은 narration_seconds 누적으로 전역 시각 산출.
범위 조정 플래그: 1.5초 미만/7초 초과 큐, 18자 초과 줄을 "편집 권장 목록" 에 기록.
SRT 저장: UTF-8 BOM + CRLF. 씬별(ch{NN}_{SS}.srt) + 합본(ch{NN}_full.srt).
편집 포인트 리포트: 사용자에게 규칙 위반 큐 목록을 경로와 함께 제시.

산출물

workspace/ch{NN}/subtitles/ 에 씬별 SRT M개 + 합본 SRT 1개.

재실행 주의

재실행 시 subtitles/ 의 파일을 덮어쓴다. 사람이 편집한 내용이 유실되므로, 재생성 전 사용자에게 백업 여부 확인.

TODO (코웍 세션에서 구현)

문장 분절 알고리즘(한국어 특화), 타이밍 배분, SRT 직렬화(BOM·CRLF), 규칙 위반 감지는 차기 코웍 세션에서 구현한다. 이 파일은 스텁이다.

---name: build-subtitlesdescription: workspace/ch{NN}/script.json의 scenes[].narration_text를 한국어 SRT 자막으로 변환한다. 문장 단위 분절, narration_seconds 기반 타이밍 계산, UTF-8 BOM + CRLF 인코딩, 줄 길이·큐 길이 규칙 검증을 수행하고 편집 권장 목록을 제시한다. 씬별 SRT + 합본 SRT를 저장한다. 사용자가 "자막 만들어줘", "SRT 생성", "/weave-subtitle"라고 요청하면 이 스킬을 사용한다.---# 자막 생성 (Build Subtitles)내레이션 텍스트를 CapCut 호환 SRT 자막 파일로 변환한다. 사람이 최종 검수·수정할 것을 전제로 한다.## 사전 조건- `workspace/ch{NN}/script.json` 이 존재해야 함 (`/weave-ingest` 선행)- `knowledge/subtitle-style-guide.md` 의 규칙을 따른다## 처리 단계1. **script.json 로드**: `scenes[]` 의 `narration_text` 와 `narration_seconds` 수집.2. **문장 분절**: `.`, `?`, `!`, `。` 경계로 1차 분할. 긴 문장은 접속사 경계에서 2차 분할.3. **타이밍 계산**: 씬 내 각 큐 지속 시간 = `(cue_chars / scene_chars) × narration_seconds`. 씬 간은 `narration_seconds` 누적으로 전역 시각 산출.4. **범위 조정 플래그**: 1.5초 미만/7초 초과 큐, 18자 초과 줄을 "편집 권장 목록" 에 기록.5. **SRT 저장**: UTF-8 BOM + CRLF. 씬별(`ch{NN}_{SS}.srt`) + 합본(`ch{NN}_full.srt`).6. **편집 포인트 리포트**: 사용자에게 규칙 위반 큐 목록을 경로와 함께 제시.## 산출물`workspace/ch{NN}/subtitles/` 에 씬별 SRT M개 + 합본 SRT 1개.## 재실행 주의재실행 시 `subtitles/` 의 파일을 **덮어쓴다**. 사람이 편집한 내용이 유실되므로, 재생성 전 사용자에게 백업 여부 확인.## TODO (코웍 세션에서 구현)문장 분절 알고리즘(한국어 특화), 타이밍 배분, SRT 직렬화(BOM·CRLF), 규칙 위반 감지는 차기 코웍 세션에서 구현한다. 이 파일은 스텁이다.

Frequently asked questions