ScreenKite Guide

https://www.screenkite.com/guide
Admin
ScreenKite Guide provides comprehensive documentation and tutorials for using ScreenKite, a screen...
Tokens:11,084
Snippets:207
Trust Score:6.3
Update:4 months ago
Show doc for...
Tokens:
Raw
### Install ScreenKite Skills

Source: https://www.screenkite.com/guide/agentic-video-editing

Installs a collection of pre-built prompt bundles (skills) for ScreenKite, enabling complex workflows with simple references.

```shell
npx skills add ScreenKite/awesome-ai-video-editing

```

--------------------------------

### Agent's Proposed Cut Plan Output

Source: https://www.screenkite.com/guide/agentic-video-editing

This is an example of the output you might receive from the agent, detailing proposed cuts with timestamps and reasons. It shows filler words, transitions, and false starts identified for removal.

```text
[000.06–000.66]  "HelloPro."          → false start
[002.14–002.56]  "Hello."             → second false start
--- CUT [0 → 2.98s] ---
[011.84–012.18]  "Uh,"                → filler      CUT [8.72–10.00]
[043.60–045.16]  "And let's see."     → transition  CUT [40.48–42.60]

Result: 58.8s → 51.2s
Apply these 3 cuts?

```

--------------------------------

### Start Interactive Claude Session

Source: https://www.screenkite.com/guide/agentic-video-editing

Initiates an interactive session with the Claude agent in your project folder. You can then issue commands naturally.

```shell
# Start an interactive session in your project folder
claude

# Then type:
Open ~/Desktop/Recording.skbundle and do a transcript cut. Plan the cuts first.

```

--------------------------------

### Agentic Video Editing Workflow

Source: https://www.screenkite.com/guide/agentic-video-editing

This snippet demonstrates a typical interactive session with Claude for video editing. It covers starting the agent, transcribing and planning cuts, adding B-roll with specific visual instructions, spot-checking specific segments, and making minor visual adjustments.

```bash
# 1. Start Claude Code in your project folder
claude

# 2. Transcription cut
"Open ~/Desktop/Recording.skbundle. Transcribe and plan cuts. ElevenLabs key at ~/.config/env/elevenlabs.env"
# → review cut list → "yes"

# 3. B-roll
"Add B-roll — centered layout, medium density, cute English visuals"
# → review 7-slot beat menu → "Medium, looks good"
# → agent generates in parallel, renders serially, applies DSL (~3 min)

# 4. Spot-check
"Show me slot 4 at 18s"
# → scrub in ScreenKite

# 5. Tweak if needed
"Slot 4 — change the node diagram to use mint green for all nodes"

```

--------------------------------

### Sample Agent Prompt for Transcription and Cutting

Source: https://www.screenkite.com/guide/agentic-video-editing

Use this prompt to instruct the agent to transcribe audio, identify cuts, and present a cut plan before modifying the timeline. Ensure your ElevenLabs API key is configured.

```bash
Open ~/Desktop/Recording.skbundle and transcribe + cut.
Show me the cut plan first, don't touch the timeline yet.
ElevenLabs key is in ~/.config/env/elevenlabs.env

```

--------------------------------

### ScreenKite CLI: Open Project

Source: https://www.screenkite.com/guide/agentic-video-editing

The underlying ScreenKite CLI command to open a specified project bundle. Use the --json flag for machine-readable output.

```shell
# Open the project
'/Applications/ScreenKite.app/Contents/MacOS/ScreenKite' agent project open \
  --path ~/Desktop/Recording.skbundle --json

```

--------------------------------

### Generate Word-Level Captions via Agent

Source: https://www.screenkite.com/guide/generated-captions

Use this command to instruct an agent to open a project and generate word-level captions from the microphone track.

```bash
codex "Open ~/Desktop/Recording.skbundle and generate word-level captions from the microphone track"
```

--------------------------------

### Gemini CLI Command for Transcription and Cut Planning

Source: https://www.screenkite.com/guide/agentic-video-editing

Instructs the Gemini CLI to open a project, transcribe audio, plan cuts, and display the cut list for review before modifying the timeline.

```shell
gemini "Open ~/Desktop/Recording.skbundle. Transcribe the mic, plan the cuts, and show me the list before touching the timeline."

```

--------------------------------

### ScreenKite CLI: Read Project State

Source: https://www.screenkite.com/guide/agentic-video-editing

Retrieves the current state of a ScreenKite project, specifically requesting a summary. The --json flag ensures machine-readable output.

```shell
# Read project state
'/Applications/ScreenKite.app/Contents/MacOS/ScreenKite' agent tool call \
  --name getProjectState --input-json '{"scope":"summary"}' --json

```

--------------------------------

### Corner PiP Layout Prompt

Source: https://www.screenkite.com/guide/agentic-video-editing

Use this prompt to add B-roll with the default corner picture-in-picture layout.

```shell
# Corner PiP (default)
claude "add B-roll with corner layout"
```

--------------------------------

### Centered B-roll Layout Prompt

Source: https://www.screenkite.com/guide/agentic-video-editing

Use this prompt to add B-roll with a centered layout, minimizing the screen recording to the top left.

```shell
# Centered
claude "add B-roll — minimize the screen to top left, B-roll centered, medium density, cute visuals"
```

--------------------------------

### Sample B-roll Generation Prompt

Source: https://www.screenkite.com/guide/agentic-video-editing

A comprehensive prompt for generating B-roll, specifying layout, density, visual style, and language.

```plaintext
Recording is cut.
Add B-roll:
- Centered layout (screen top-left, B-roll center)
- Medium density
- Cute, warm visuals
- All text in English
```

--------------------------------

### Codex CLI Command for Transcript Cut

Source: https://www.screenkite.com/guide/agentic-video-editing

Uses the Codex CLI to open a project, plan transcript cuts, and await approval before execution.

```shell
codex "Open ~/Desktop/Recording.skbundle and do a transcript cut — plan first, then wait for my approval"

```

--------------------------------

### Interactive Skill Invocation in Claude Code

Source: https://www.screenkite.com/guide/agentic-video-editing

Demonstrates how to invoke a loaded skill directly within an interactive Claude Code session using a slash command.

```shell
/use-screenkite-advanced-b-roll

```

--------------------------------

### One-Shot Claude Command

Source: https://www.screenkite.com/guide/agentic-video-editing

Executes a video editing task with the Claude agent directly from the terminal using a single natural language command.

```shell
# Or one-shot from the terminal
claude "Open ~/Desktop/Recording.skbundle, transcribe the mic with ElevenLabs, plan all cuts before executing"

```

--------------------------------

### Claude Command for Video Editing Skill

Source: https://www.screenkite.com/guide/agentic-video-editing

Uses the 'video-use' skill with Claude to transcribe a project and plan cuts, with potential for further editing steps.

```shell
claude "use the video-use skill. Transcribe ~/Desktop/Recording.skbundle and plan a cut."

```

--------------------------------

### Applying Cuts via editTimeline Function

Source: https://www.screenkite.com/guide/agentic-video-editing

Once you approve the proposed cuts, you can apply them to the timeline using the `editTimeline` function with the 'cut' action and a list of ranges.

```javascript
editTimeline(action: "cut", {ranges: [...]})

```

--------------------------------

### Claude Command for Advanced B-roll Skill

Source: https://www.screenkite.com/guide/agentic-video-editing

Invokes the 'use-screenkite-advanced-b-roll' skill using Claude, specifying project path, visual style, layout, and density.

```shell
claude "use the use-screenkite-advanced-b-roll skill on ~/Desktop/Recording.skbundle. Cute visuals, centered layout, medium density."

```

--------------------------------

### WhisperKit Transcription Not Configured Error

Source: https://www.screenkite.com/guide/agentic-video-editing

This message appears when WhisperKit transcription models are not downloaded or configured correctly. Users must configure a transcription provider in ScreenKite's settings before proceeding with agent commands that require transcription.

```text
WhisperKit transcription is not configured. Open Settings → Transcription and download a WhisperKit model. Stop here and ask the human to configure a transcription provider before continuing.

```

--------------------------------

### Codex CLI Command for B-roll

Source: https://www.screenkite.com/guide/agentic-video-editing

Automates the process of transcribing, cutting, and adding B-roll to a video project using the Codex CLI.

```shell
# B-roll in one go
codex "Open ~/Desktop/Recording.skbundle, transcribe and cut, then add medium-density B-roll with a centered layout"

```

--------------------------------

### Iterating on a Specific B-roll Slot

Source: https://www.screenkite.com/guide/agentic-video-editing

Instruct the agent to regenerate a specific slot with modifications, such as changing a visual element.

```plaintext
Slot 3 should show a Swift logo instead of the Apple emoji.
Re-render slot 3 and re-apply.
```

--------------------------------

### Clearing Leftover B-roll Segments Manually

Source: https://www.screenkite.com/guide/agentic-video-editing

If manually applying `setSceneLayout` causes leftover B-roll segments, use this command to clear them. This is a fallback for when the agent's automatic clearing fails.

```javascript
setSceneLayout(mode: "pictureInPicture")
```
Tokens:
Raw