Twitch Clip Skill

Creates a clip of the last 30–60 seconds of a live Twitch stream via the Twitch Clips API. Includes a 30-second cooldown to prevent accidental spam clipping.

Setup

1. Create a Twitch app

1. 1. Go to https://dev.twitch.tv/console/apps
2. Register a new app (OAuth Redirect URL: http://localhost, Category: Other)
3. Copy your Client ID and generate a Client Secret

2. Get an OAuth token

https://id.twitch.tv/oauth2/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost&response_type=token&scope=clips:edit

3. Set environment variables

To find your broadcaster ID:
CODEBLOCK2

Usage

Run the clip script:

bash scripts/create_clip.sh [duration_seconds]

• - Duration defaults to 30, max 60
• Stream must be live or the API returns a 404

Cooldown

A 30-second cooldown is enforced between clips. If a clip request comes in during cooldown:

• - Script exits with code 2 and prints remaining wait time
• Reply: INLINECODE3
• Do NOT retry automatically — wait for the next explicit clip request

Trigger phrases

• - "clip that"
• "clip the last X seconds"
• "make a clip"
• "clip it"

Response format

Success:
INLINECODE4

Cooldown active:
INLINECODE5

Not live:
INLINECODE6

Token refresh