AI Skills

← Back to spec · Let your AI assistant write TPS scripts for you.

If you use an AI coding assistant — Claude Code, ChatGPT, Cursor, Windsurf, or any other LLM-powered tool — you can install TPS skills so the AI converts plain text into richly formatted .tps scripts automatically.

Available Skills

SkillDescription
tps-convert Converts plain text (speeches, articles, narrations, dialogues) into fully formatted TPS files with dramatic pacing, emotions, pauses, emphasis, volume, delivery modes, pronunciation guides, stress markers, breath marks, edit points, and speaker tags — all applied intelligently based on content analysis.

What the Skill Does

The tps-convert skill teaches your AI assistant the complete TPS format specification, including every tag, attribute, and formatting rule. When you give it plain text, the AI will:

  1. Analyze the text for tone, emotional arcs, key moments, and natural structure
  2. Structure the text into TPS segments and blocks based on topic and mood shifts
  3. Apply the full TPS tag vocabulary: 12 emotions, 5 speed presets, 3 volume levels, 4 delivery modes, emphasis, highlights, pauses, breath marks, edit points, pronunciation guides, stress markers, and speaker assignments
  4. Generate complete front matter with metadata, duration estimation, and speed offsets
  5. Output a valid .tps file ready for any TPS-compatible teleprompter

Installation

Claude Code

Copy the skill file into your project’s .claude/skills/ directory:

mkdir -p .claude/skills
curl -o .claude/skills/tps-convert.md https://raw.githubusercontent.com/managedcode/TPS/main/Skills/tps-convert.md

Then use /tps-convert in Claude Code followed by your text or a file path.

ChatGPT / Custom GPTs

Copy the contents of tps-convert.md and paste it into the Instructions field of your Custom GPT or into the system prompt of your ChatGPT conversation. The skill contains the complete TPS format specification, so the AI will know how to format scripts correctly.

Cursor / Windsurf / Other AI IDEs

Add the skill file to your project’s rules or custom instructions:

  • Cursor — copy to .cursor/rules/ or add as a project rule
  • Windsurf — add to .windsurfrules or project instructions
  • Other tools — use the skill contents as a system prompt or custom instruction

Download

View on GitHub · Download raw file

TPS Format Coverage

The skill covers the entire TPS format specification:

CategoryTags / Features
Front Mattertitle, profile, duration, base_wpm, speed_offsets, author, created, version
Structure# title, ## segments, ### blocks, leading text, phrases, words
Header ParamsName, WPM, Emotion, Timing (MM:SS), Speaker:Name
Pauses/ (300ms), // (600ms), [pause:Ns], [pause:Nms]
Emphasis[emphasis], *italic*, **bold**, [highlight]
Speed[xslow], [slow], [normal], [fast], [xfast], [NWPM]
Volume[loud], [soft], [whisper]
Delivery[sarcasm], [aside], [rhetorical], [building]
EmotionsAll 12: neutral, warm, professional, focused, concerned, urgent, motivational, excited, happy, sad, calm, energetic
Breathing[breath]
Edit Points[edit_point], [edit_point:high], [edit_point:medium]
Pronunciation[phonetic:IPA], [pronunciation:GUIDE]
Stress[stress] inline wrap, [stress:SYL-LA-ble] guide
SpeakersSpeaker:Name in headers
Escapes\[, \], \|, \/, \*, \\