skills.rest
kmjy98-sketch
kmjy98-sketchCOMMUNITY
Explore all skills by this author →
GitHub

transcript-tools

Splits long Markdown transcripts into evenly sized part files using a Python script.

Updated Jun 15, 2026
Search Tags:#transcript#markdown#python#split#text processing#chunking#file splitting
One-click install
npx skills add https://github.com/kmjy98-sketch/khulaw --skill transcript-tools-kmjy98-sketch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: transcript-tools
Source: https://github.com/kmjy98-sketch/khulaw/tree/main/.agent/skills/transcript-tools
Command: npx skills add https://github.com/kmjy98-sketch/khulaw --skill transcript-tools-kmjy98-sketch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Long transcripts are difficult to process in a single pass, so this Skill divides a Markdown transcript into a configurable number of part files while preserving front matter and cutting at natural boundaries like headers or blank lines. ## Core Features & Use Cases - Transcript Splitting: Divides a Markdown transcript into N parts (default 10) with balanced line counts per chunk. - Smart Cut Points: Prefers splitting at Markdown headers or blank lines instead of breaking mid-paragraph, and preserves YAML front matter in every output part. - Dry-Run Mode: Preview the split plan and character counts without writing any files. - Use Case: After transcribing a two-hour lecture recording, split the resulting transcript into 10 parts so each part can be corrected or summarized individually in a downstream workflow. ## Quick Start Split the attached transcript file into 10 parts using the transcript-tools split script and save the parts to an output folder.

Frequently Asked Questions about transcript-tools

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I split a large Markdown transcript into smaller parts?▼

Run the split_transcript.py script with the transcript file path and the --parts option to set the number of output files. The script writes files named with a _partNN suffix into the chosen output directory.

How to split a text file at paragraph or header boundaries in Python?▼

The script scans candidate cut positions near the target size and prefers Markdown headers first, then blank lines, so chunks break at natural boundaries. If neither exists nearby, it falls back to the computed target line index.

Does the transcript splitter preserve YAML front matter?▼

Yes, the script detects a leading YAML front matter block and prepends it to every generated part file. The body content is then split independently of the header.

Can I preview the split without creating files?▼

Yes, pass the --dry-run flag to print the planned output filenames and character counts for each part. No files are written in dry-run mode.

What are the limitations of line-based transcript splitting?▼

Splitting is based on line counts rather than semantic topics, so parts may not align with subject changes in the transcript. It also requires a local Markdown or text file and does not handle audio transcription itself.

Related Skills

Explore More Content & Communication Skills→
malue-aimalue-ai
36

openai-whisper

Transcribe audio files into text using the OpenAI Whisper CLI.

Official
Basic
VanLengsVanLengs
1

assemble-document

Merge doc parts into a publication-ready markdown document with quality report.

Community
Intermediate
MerkyorLynnMerkyorLynn
37

audiobook-maker

Split long text into chaptered TTS audio segments and save them.

Community
Intermediate
GongLingRuiGongLingRui
330

text-splitter

Split long text into uniform chunks at sentence or paragraph boundaries.

Community
Intermediate