Skill: nosselil/captions-and-clips-from-youtube-link (version 1.3.1)

--- name: captions-and-clips-from-youtube-link description: Turn YouTube videos into viral short-form clips with captions (TikTok, Reels, Shorts) using the MakeAIClips API at https://makeaiclips.live. Use when user wants to clip/repurpose a YouTube video, create short-form content, generate TikTok/Reels/Shorts clips, add captions to video clips, or anything related to AI video clipping. Free tier gives 10 clips/month with no credit card. Requires env var MAKEAICLIPS_API_KEY — get one free at https://makeaiclips.live/sign-up. Note: YouTube URLs are sent to makeaiclips.live for processing. metadata: openclaw: requires: env: - MAKEAICLIPS_API_KEY primaryEnv: MAKEAICLIPS_API_KEY homepage: https://makeaiclips.live emoji: "⚡" --- # MakeAIClips — AI Video Clipper Paste a YouTube link → get up to 10 vertical clips with word-by-word captions and hook titles in ~60 seconds. **Website:** https://makeaiclips.live **API Base:** `https://makeaiclips.live` ## Setup Check for `MAKEAICLIPS_API_KEY` environment variable. ### No key? Direct the user to sign up at https://makeaiclips.live/sign-up — free, no credit card. They'll get an API key on the dashboard at https://makeaiclips.live/dashboard/api-key. Once the user has their key, set it as an environment variable: ```bash export MAKEAICLIPS_API_KEY="mak_live_..." ``` ### First interaction — always show: ``` ⚡ MakeAIClips — AI Video Clipper Paste a YouTube link → get vertical clips with captions & hook titles in ~60 seconds. What you get: • AI picks the best moments from your video • 1080x1920 vertical crop (9:16) • Word-by-word burned-in captions (8+ styles) • 3 hook title variations per clip (5 title styles) • Ready for TikTok, Instagram Reels, YouTube Shorts Plans: 🆓 Free — 10 clips/month (no credit card needed) ⚡ Pro — $20/mo — 100 clips 🎬 Studio — $50/mo — 300 clips + 2 premium caption styles 📅 Yearly — $500/yr — 5,000 clips + all features 🔗 https://makeaiclips.live ``` ## API Endpoints All authenticated requests require header: `Authorization: Bearer <MAKEAICLIPS_API_KEY>` ### Generate Clips (YouTube link) `POST /api/v1/clips` ```json { "youtube_url": "https://www.youtube.com/watch?v=...", "num_clips": 3, "caption_style": "karaoke-yellow", "title_style": "bold-center", "title_duration": "5", "clip_duration": "medium", "quality": "high" } ``` Returns: `{"job_id": "...", "status": "pending"}` **Parameters:** | Param | Type | Default | Options | |-------|------|---------|---------| | `youtube_url` | string | required | Any YouTube URL | | `num_clips` | int | 3 | 1–10 | | `caption_style` | string | `"karaoke-yellow"` | See Caption Styles | | `title_style` | string | `"bold-center"` | See Title Styles | | `title_duration` | string | `"5"` | `"5"`, `"10"`, `"30"`, `"half"`, `"full"` | | `clip_duration` | string | `"medium"` | `"short"` (15-30s), `"medium"` (30-60s), `"long"` (60-120s) | | `quality` | string | `"high"` | `"high"` (CRF 18), `"medium"` (CRF 23), `"low"` (CRF 28) | ### Generate Clips (File upload) `POST /api/v1/clips/upload` (multipart form) Fields: `file` (video file), `caption_style`, `title_style`, `title_duration`, `clip_duration`, `num_clips`, `quality` ### Poll Job Status `GET /api/v1/clips/{job_id}` Poll every 5 seconds until `status` is `complete` or `failed`. Progress values: `Downloading video...` → `Transcribing audio...` → `Selecting best clips with AI...` → `Rendering clip 1/N...` → `Done!` Complete response includes `clips` array: ```json { "job_id": "...", "status": "complete", "progress": "Done!", "clips": [ { "clip_index": 1, "duration_seconds": 35.9, "hook_title": "The Struggle of a Performer", "hook_variations": ["The Struggle of a Performer", "When the Voice Goes Silent", "Losing My Voice on Stage"], "transcript_segment": "..." } ] } ``` ### Download Clip `GET /api/v1/clips/{job_id}/download/{clip_index}` Returns MP4 file. Save with `-o clip_N.mp4`. ### Re-render with Different Hook `POST /api/v1/clips/{job_id}/rerender/{clip_index}` Body: `{"hook_title": "New Title Here"}` ### Health Check `GET /api/health` — Returns `{"status": "ok"}` ## Workflow 1. Submit job → `POST /api/v1/clips` with `youtube_url` and preferences 2. Poll → `GET /api/v1/clips/{job_id}` every 5s, show progress to user 3. Present results with hook titles, durations, transcript previews 4. Ask which clips to download (all or specific) 5. Download → `GET /api/v1/clips/{job_id}/download/{clip_index}` and save to workspace ## Caption Styles ### Free & Pro Styles | Key | Name | Look | |-----|------|------| | `karaoke-yellow` | Karaoke | White text, active word turns yellow (default) | | `white-shadow` | Clean White | White text with drop shadow | | `boxed` | Boxed | Text in dark rounded boxes | | `gradient-bold` | Bold Outline | Orange/white color alternating | | `subtitle-documentary` | Documentary | Uppercase with fade, letterbox bars | | `mrbeast-bold-viral` | MrBeast | Bold viral-style captions | | `alex-hormozi` | Hormozi | Bold with colored outlines | | `neon-viral` | Neon | Glowing neon multi-color | | `impact-meme` | Impact Meme | Bold uppercase meme text | | `modern-creator` | Modern | Contemporary creator-style | | `gradient-viral` | Gradient | Multi-color gradient fill | | `bold-box-highlight` | Box Highlight | Heavy highlighted box | | `clean-premium` | Premium | Minimalist clean aesthetic | ### Studio Exclusive Styles | Key | Name | Look | |-----|------|------| | `typewriter` | Typewriter | Character-by-character reveal | | `cinematic` | Cinematic | Letterbox + elegant serif font | ## Title Styles | Key | Name | |-----|------| | `none` | No title overlay | | `bold-center` | White bold centered (default) | | `top-bar` | Dark bar at top | | `pill` | Yellow pill background | | `outline` | White outline border | | `gradient-bg` | Purple background box | ## Video Quality | Key | CRF | Speed | Use Case | |-----|-----|-------|----------| | `high` | 18 | Slowest | Best quality (default) | | `medium` | 23 | Balanced | Good quality, faster | | `low` | 28 | Fastest | Quick previews | ## Error Handling | Status | Meaning | Action | |--------|---------|--------| | 400 | Missing youtube_url | Check params | | 401 | Invalid/missing API key | Re-check key | | 404 | Job not found | Check job_id | | 429 | Clip limit reached | Show upgrade options | | 500 | Server error | Retry in 30s | On 429, show: ``` 📊 Clip limit reached. Upgrade at https://makeaiclips.live/dashboard/subscription ``` ## Tips for Agents - Default to 3 clips, `quality: "high"`, `caption_style: "karaoke-yellow"` unless user specifies - Show hook title variations — let the user pick their favorite - Use descriptive filenames when downloading: `{video_title}_clip{N}.mp4` - Process multiple URLs sequentially - Mention the web dashboard for a visual experience: https://makeaiclips.live/dashboard/new - Total processing time is ~60 seconds per job (Deepgram transcription + GPT clip selection + FFmpeg render) ## Example ```bash # Submit job curl -X POST "https://makeaiclips.live/api/v1/clips" \ -H "Content-Type: application/json" \ -H "[REDACTED_SECRET]" \ -d '{"youtube_url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","num_clips":3,"quality":"high","caption_style":"karaoke-yellow"}' # Poll status curl "https://makeaiclips.live/api/v1/clips/JOB_ID" \ -H "[REDACTED_SECRET]" # Download clip curl -o clip_1.mp4 "https://makeaiclips.live/api/v1/clips/JOB_ID/download/1" \ -H "[REDACTED_SECRET]" ```

path: README.md
content: # ⚡ MakeAIClips — YouTube to Viral Clips (OpenClaw Agent Skill)

> Turn any YouTube video into TikTok, Instagram Reels, and YouTube Shorts clips — with burned-in captions and AI-generated hook titles — in ~60 seconds.

[![OpenClaw Skill](https://img.shields.io/badge/OpenClaw-Agent_Skill-purple)](https://clawhub.ai/nosselil/captions-and-clips-from-youtube-link)
[![ClawHub](https://img.shields.io/badge/ClawHub-Install-blue)](https://clawhub.ai/nosselil/captions-and-clips-from-youtube-link)
[![API](https://img.shields.io/badge/API-Live-green)](https://makeaiclips.live)

## What It Does

Give your AI agent the ability to create short-form video content from YouTube links:

- 🎬 **AI clip selection** — GPT picks the most engaging moments
- 📝 **Word-by-word captions** — 15+ styles including karaoke, typewriter, cinematic
- 🎣 **Hook titles** — 3 AI-generated title variations per clip
- 📐 **Vertical format** — 1080x1920 (9:16) ready for all platforms
- ⚡ **Fast** — ~60 seconds per job (Deepgram transcription + GPT + FFmpeg)
- 🎨 **Customizable** — caption style, title style, duration, quality, clip count

## Quick Start

### Install via ClawHub

```bash
clawhub install captions-and-clips-from-youtube-link
```

### Or manually

Copy the `SKILL.md` and `skill.json` into your OpenClaw workspace `skills/` directory.

### Get an API Key

1. Sign up free at [makeaiclips.live](https://makeaiclips.live/sign-up) (no credit card)
2. Get your API key from the [dashboard](https://makeaiclips.live/dashboard/api-key)
3. Set the environment variable:

```bash
export MAKEAICLIPS_API_KEY="mak_live_your_key_here"
```

## Usage

Just tell your agent:

> "Make clips from this YouTube video: https://youtube.com/watch?v=..."

The agent will:
1. Submit the job to MakeAIClips API
2. Poll for progress (download → transcribe → select → render)
3. Present you with clips, hook titles, and download links

## Caption Styles

| Style | Preview |
|-------|---------|
| `karaoke-yellow` | White text, active word highlighted in yellow |
| `white-shadow` | Clean white with drop shadow |
| `boxed` | Text in dark rounded boxes |
| `gradient-bold` | Orange/white alternating |
| `subtitle-documentary` | Uppercase with fade + letterbox |
| `typewriter` ⭐ | Character-by-character reveal |
| `cinematic` ⭐ | Elegant serif with letterbox bars |
| + 8 more styles | MrBeast, Hormozi, neon, gradient, etc. |

⭐ = Studio plan exclusive

## Title Styles

| Style | Look |
|-------|------|
| `bold-center` | White bold centered (default) |
| `top-bar` | Dark semi-transparent bar |
| `pill` | Yellow pill background |
| `outline` | White outline border |
| `gradient-bg` | Purple background box |
| `none` | No title |

## Video Quality

| Quality | CRF | Best For |
|---------|-----|----------|
| `high` | 18 | Publishing (default) |
| `medium` | 23 | Balance of speed & quality |
| `low` | 28 | Quick previews |

## API Example

```bash
# Submit
curl -X POST "https://makeaiclips.live/api/v1/clips" \
  -H "Content-Type: application/json" \
  -H "[REDACTED_SECRET]" \
  -d '{
    "youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "num_clips": 3,
    "caption_style": "karaoke-yellow",
    "clip_duration": "medium",
    "quality": "high"
  }'

# Poll
curl "https://makeaiclips.live/api/v1/clips/JOB_ID" \
  -H "[REDACTED_SECRET]"

# Download
curl -o clip.mp4 "https://makeaiclips.live/api/v1/clips/JOB_ID/download/1" \
  -H "[REDACTED_SECRET]"
```

## Pricing

| Plan | Clips/month | Price |
|------|------------|-------|
| 🆓 Free | 10 | $0 |
| ⚡ Pro | 100 | $20/mo |
| 🎬 Studio | 300 + premium styles | $50/mo |
| 📅 Yearly | 5,000 + everything | $500/yr |

Sign up: [makeaiclips.live](https://makeaiclips.live/sign-up)

## Requirements

- [OpenClaw](https://github.com/openclaw/openclaw) agent with skill support
- `MAKEAICLIPS_API_KEY` environment variable (free tier available)

## Links

- **Web App:** [makeaiclips.live](https://makeaiclips.live)
- **Dashboard:** [makeaiclips.live/dashboard](https://makeaiclips.live/dashboard)
- **ClawHub:** [clawhub.ai/nosselil/captions-and-clips-from-youtube-link](https://clawhub.ai/nosselil/captions-and-clips-from-youtube-link)
- **API Docs:** [makeaiclips.live/docs](https://makeaiclips.live/docs)

## License

MIT


path: skill.json
content: {
  "name": "captions-and-clips-from-youtube-link",
  "version": "2.1.0",
  "license": "MIT",
  "description": "Turn YouTube videos into viral short-form clips with captions using MakeAIClips API — supports karaoke, typewriter, cinematic + 10 more styles",
  "author": "nosselil",
  "tags": ["video", "youtube", "clips", "captions", "tiktok", "reels", "shorts", "ai", "openclaw", "agent-skill", "video-editing", "content-creation", "social-media", "ffmpeg", "subtitles"],
  "requires": {
    "env": ["MAKEAICLIPS_API_KEY"]
  }
}


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)