boosta-long-to-shorts

# Boosta Video Api

## Overview

Use this skill to execute end-to-end Boosta API workflows: submit job, poll until completion, return clip URLs, and handle common API failures.
Prefer the bundled script for deterministic execution and consistent error handling.

## Quick Start Workflow

1. Validate required inputs:
- `video_url` (required)
- `video_type` (required, see [references/video-types.md](references/video-types.md))
- `config_name` (optional)

2. Validate credentials:
- Require `BOOSTA_API_KEY` in environment.
- Never print or store raw API keys in output.

3. Submit job:
- Endpoint: `POST /api/v1/jobs`
- Base URL: `https://boosta.pro/api/v1`
- Body: `video_url`, `video_type`, optional `config_name`

4. Poll status:
- Endpoint: `GET /api/v1/jobs/:job_id`
- Stop when `status=completed` or `status=failed`.
- If completed, return `clip_urls`.

5. Handle API errors:
- `401`: invalid or missing key
- `400`: invalid payload (missing `video_url`, invalid `video_type`)
- `403`: no credits
- `429`: rate limited (respect `retry_after`)
- `active_job_exists`: reuse returned `job_id` and continue polling

## Commands

Use the bundled script:

```bash
python3 scripts/boosta_job.py --help
```

Submit and wait for completion:

```bash
export BOOSTA_API_KEY="sk_live_..."
python3 scripts/boosta_job.py submit \
  --video-url "https://youtube.com/watch?v=xxx" \
  --video-type "conversation" \
  --config-name "My Config" \
  --wait
```

Check status:

```bash
python3 scripts/boosta_job.py status --job-id "job_1234567890_abc123"
```

List completed jobs:

```bash
python3 scripts/boosta_job.py list
```

Check usage:

```bash
python3 scripts/boosta_job.py usage
```

## Output Contract

When user asks to create clips, return:
- `job_id`
- final `status`
- `clips_count` if present
- `clip_urls` when completed
- clear next step if processing/failed

When user asks only to check status, return:
- `job_id`
- current `status`
- `progress`/`step` if present

## Decision Rules

- If user...

# Boosta Long to Shorts Skill for OpenClaw

Create viral short clips from long-form video using the Boosta API directly from OpenClaw workflows.

[![Boosta](https://img.shields.io/badge/Boosta-API-0ea5e9)](https://boosta.pro)
[![Docs](https://img.shields.io/badge/Docs-boosta.pro%2Fapi-22c55e)](https://docs.boosta.pro/api/getting-started)
[![OpenClaw Skill](https://img.shields.io/badge/OpenClaw-Skill-f59e0b)](https://docs.openclaw.ai/tools/skills)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)

## Quick Links

- Website: [boosta.pro](https://boosta.pro)
- API Docs: [API Getting Started](https://docs.boosta.pro/api/getting-started)
- Auth: [Authentication](https://docs.boosta.pro/api/authentication)
- Endpoints: [API Endpoints](https://docs.boosta.pro/api/endpoints)
- Video Types: [Video Types (API)](https://docs.boosta.pro/api/video-types)
- Errors: [API Errors](https://docs.boosta.pro/api/errors)

## Table of Contents

- [What This Skill Does](#what-this-skill-does)
- [Who This Skill Is For](#who-this-skill-is-for)
- [Features](#features)
- [Project Structure](#project-structure)
- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [Install as a Skill (skills.sh)](#install-as-a-skill-skillssh)
- [Install from ClawHub](#install-from-clawhub)
- [API Flow](#api-flow)
- [Error Handling](#error-handling)
- [Video Type Mapping](#video-type-mapping)
- [Release Process](#release-process)
- [SEO Keywords](#seo-keywords)
- [License](#license)

## What This Skill Does

`boosta-long-to-shorts` is an OpenClaw-compatible skill that helps agents:

- Submit a new Boosta job from a source video URL
- Poll and track job status
- Return final `clip_urls` once processing is complete
- Handle API errors, retries, and one-active-job constraints
- Map content to the correct Boosta `video_type`

This is designed for production-style automation where reliability and clear status reporting matter.

## Who This Skill Is For

- C...