Skip to content

thesatvik/frameos

v0.1.0MIT

Turn long videos into captioned short clips with FrameOS: submit a link or upload, track the render, restyle captions, export MP4s, make thumbnails, draft social copy, and post to connected accounts.

frameos-captions

Change how the captions look on FrameOS clips and deliver a captioned MP4. Use when the user wants a different caption style, font, size, position or animation, wants captions removed, asks for a named look such as MrBeast style or a clean podcast look, or wants a download that shows the new captions. Works for new overlay-caption clips and older burned-in clips, and holds the full catalogue of 22 styles, 16 fonts and 17 animations. For making clips from a video use frameos-clip; for posting a restyled clip use frameos-publish; for thumbnails use frameos-thumbnails; for finding, copying or organising existing clips use frameos-library.

frameos-clip

Turn a long video into short clips with FrameOS and deliver them. Use when the user wants clips, shorts, reels or highlights cut from a video link (YouTube, Vimeo, Twitch, Kick, a public Google Drive file, a direct video URL) or from a local video file, asks how a FrameOS render is going, or wants finished clips listed or downloaded as MP4 files. Covers the credit check, submitting, waiting for the render, presenting ranked clips and exporting files. Route caption looks to frameos-captions, thumbnails to frameos-thumbnails, social copy and posting to frameos-publish, transcript search and quotes to frameos-find-moments, older projects and collections to frameos-library, multi-step content packs to frameos-repurpose, and sign-in or connection problems to frameos-setup.

frameos-find-moments

Search, quote and summarise the transcript of a video FrameOS has already processed. Use when the user asks where a topic comes up in an episode, wants quotes with timestamps, a summary or chapter list, which existing clips cover a topic, or ideas for clip-worthy moments and a focus prompt for a new run. Read-only - it never starts a render. To make new clips from a moment, hand off to frameos-clip with the focus prompt drafted here; caption looks are frameos-captions; browsing and organising clips is frameos-library; a full content pack from one episode is frameos-repurpose.

frameos-library

Find and organise work that already exists in FrameOS: recent projects and why one failed, a project's clips ranked by score, one clip's details and transcript, free copies of a clip, collections of clips and bulk export of a collection, credit spend over the last 30 days, and the workspace brand kit. Use when the user asks what they have made, where an earlier video or clip is, to group or bulk-download clips, or where their credits went. For making new clips use frameos-clip; caption looks frameos-captions; searching a full video transcript frameos-find-moments; thumbnails frameos-thumbnails; post copy and posting frameos-publish; a multi-step content pack from one episode frameos-repurpose.

frameos-publish

Draft social copy for FrameOS clips and post clips to connected YouTube, Facebook Page, Instagram Business and LinkedIn accounts, one confirmed post at a time. Use when the user wants a title, caption or hashtags for a clip, asks which social accounts are connected, or explicitly asks to post or publish a clip. TikTok and X get copy plus a download link only. Drafting or preparing never posts. Routing: making or exporting clips is frameos-clip, changing the caption look is frameos-captions, thumbnails are frameos-thumbnails, a multi-clip content pack is frameos-repurpose, sign-in or connection errors are frameos-setup.

frameos-repurpose

Plan and run a full content pack from one long video: several short clips shaped for each platform, one caption style, optional thumbnails, draft post copy per platform and a collection that keeps the pack together, all under one upfront plan with a credit estimate that the user approves. Use when the user asks to repurpose an episode, turn a video into a week of content, build a content pack, or prepare clips for several platforms at once, or to resume a pack. It orchestrates the sibling skills frameos-clip, frameos-captions, frameos-thumbnails, frameos-publish, frameos-library and frameos-find-moments; for a single task such as only clips, one caption change or one post, use that skill directly.

frameos-setup

Connect FrameOS to this agent, prove the connection works, and fix sign-in or connection problems. Use when the user asks to install, connect, set up, log in to or reconnect FrameOS, asks whether FrameOS is connected or what it can do, or when any FrameOS tool fails with a sign-in, permission, scope, connection or unavailable error. Runs a live account check, summarises workspace, plan and credit balance, gives reconnect steps for each app, and suggests first actions. Clipping a video belongs to frameos-clip; credit history, projects and collections belong to frameos-library.

frameos-thumbnails

Make up to three thumbnail images for a FrameOS clip, a whole FrameOS project, or a public video link, built from real frames of the video with a headline layout and optionally matched to a reference thumbnail style. Use when the user asks for a thumbnail, a cover image, a YouTube thumbnail, a Shorts or Reels cover, or wants earlier thumbnails again. Costs 10 credits per delivered thumbnail, so state the cost first. Routing: making clips is frameos-clip, posting is frameos-publish (posts do not attach a thumbnail), full content packs are frameos-repurpose, sign-in errors are frameos-setup.