The Kestroll skill

---
name: kestroll
description: Use Kestroll's AI video editor through its MCP server or the kestroll CLI — find specific moments, edit videos, render final cuts, and manage the media library. Trigger when the user mentions "kestroll", asks to edit/cut a video, find a moment in footage, manage their social media content, post to socials, or anything else related to media/video management.
---

# Kestroll

## What Kestroll is and your role

Kestroll is a media content management platform, optimized for human-agent collaboration. Kestroll is designed to serve as the central hub for a user's entire social media operation. It empowers you to run a user's social media: searching footage, editing videos, posting to socials, analyzing performance data, looking at other creator's content. It is an entire suite of tools.

**Live guidance beats this file.** Every Kestroll tool carries its current input schema plus usage guidance — in the tool's description over MCP, or from `kestroll tools describe <tool>` with the CLI. `kestroll --help` shows the latest CLI commands.

## Why Kestroll?

Kestroll offers you a rich suite of media management features:

1. **Detailed Asset Understanding and Search**: use the `search` tool to find moments by transcript or visuals by querying the detailed metadata embeddings. Every uploaded asset is indexed by a robust AI-analysis pipeline providing rich data about each asset. You can view the data for an asset using the `get_asset_data tool` such as moment-by-moment summary, people that appear in it, diarized transcript, scene-by-scene layout, metadata, and other custom user data. You can also inspect a frame visually using the tool, or easily delegate to a video understanding agent to answer questions about it.
3. **Visual Editing**: Kestroll presents a video editor UI that the user can use to easily watch and edit the edited composition. This makes it easy to collaborate, fine-tune and iterate quickly. 
4. **Export and Direct Posting**: Kestroll allows you to export your compositions as XML so you can continue it in another NLE, or else export as an mp4 (converting the YAML preview using ffmpeg on the Kestroll servers). You can also post an edited video directly to certain platforms.
5. **Editing Utilities**: Some common editing utilities are available to you as Kestroll tools, such as tracking a person as they move throughout a clip, auto-clipping silences and filler words, duplicating compositions, syncing assets based on timecode or transcript, adding styled captions, and more with a single tool call.
6. **Generative Abilities**: You can generate images, videos, or motion graphics directly into the Kestroll media library without needing to configure other tools.
7. **Social Analytics**: Kestroll provides insights about performance of posts: views, likes, etc. that allows you to build systems to optimize performance.

## Connecting

You reach the same Kestroll tools one of two ways. Use whichever is set up; if both are, call tools over MCP and use the CLI for uploads and downloads.

**MCP** — an HTTP MCP server at `https://api.kestroll.com/app/mcp`, authenticated with an organization API key (Settings → API Keys) sent as `Authorization: Bearer <key>`. Kestroll's tools appear alongside your own; your client may prefix their names with the server name.

**CLI** —
- `kestroll login` — authenticate through the browser. Verify with `kestroll me`.
- Credentials live in `~/.kestroll/auth.json`. `kestroll logout` revokes the session.
- Where no browser can open, the user can export an organization API key as `KESTROLL_TOKEN`; it takes precedence over any browser login. Do not run `kestroll logout` — it does not revoke an API key.
- If a command described here is missing from your installed CLI, run `kestroll update`.

## Editing
Editing with Kestroll works via the concept of **composition**. We have a specific schema expressed as JSON. If you are asked to edit anything, make sure to consult the docs especially _composition schema_ so that you know how the schema works.