---
name: video-transcript-library
description: Search, read, compare, and summarize the user's private Video Transcript Generator library through the `vtg` CLI. Use when the user asks to find something from previously extracted YouTube transcripts, locate quotes or timestamps, compare ideas across videos, inspect saved summaries, create a summary, submit a new video, or check transcript quota and credits.
---

# Video Transcript Library

Use the `vtg` CLI. Never expose the API key in chat, logs, commands shown to the user, or generated files.

## Install

Install the CLI on macOS or Linux:

```bash
curl -fsSL https://videotranscriptgenerator.net/downloads/vtg/install.sh | sh
```

Create an API key at `https://videotranscriptgenerator.net/account`, then save it locally:

```bash
vtg auth set <api-key>
```

The key is stored in the user's OS config directory with mode `0600`. Prefer the saved key; use `VTG_API_KEY` only for ephemeral automation.

## Workflow

1. Confirm the CLI is available with `vtg quota`. If authentication is missing, ask the user to create an API key in their account page and run `vtg auth set <key>` locally.
2. Search before fetching full transcripts:

   ```bash
   vtg search --limit 10 "topic or phrase"
   ```

3. Fetch only the relevant transcript IDs:

   ```bash
   vtg get <transcript-id>
   ```

4. Answer with the video title, transcript ID, and timestamped evidence. Distinguish verbatim transcript evidence from your interpretation.
5. When asked for a summary, synthesize a concise Markdown summary from the transcript, then persist it:

   ```bash
   printf '%s' "$SUMMARY" | vtg summary set <transcript-id>
   ```

6. Read a saved summary without downloading the full transcript:

   ```bash
   vtg summary get <transcript-id>
   ```

## Commands

- `vtg list --limit 20` — recent transcript jobs.
- `vtg search "query"` — search title, URL, transcript text, and saved summary.
- `vtg get <id>` — retrieve transcript metadata, summary, and timestamped segments.
- `vtg status <id>` — query a submitted task and retrieve its current status.
- `vtg submit <youtube-url>` — queue a new transcript.
- `vtg summary get <id>` — retrieve a saved summary.
- `vtg summary set <id> --file summary.md` — persist a summary.
- `vtg quota` — show this week's free usage, credit balance, and subscription state.

## API Contract

Base URL: `https://videotranscriptgenerator.net`. The CLI authenticates with `Authorization: Bearer vtg_live_...`.

- `GET /api/transcript-access` — weekly quota, credits, subscription.
- `GET /api/transcripts?limit=20` — recent jobs.
- `GET /api/transcripts/search?q=...&limit=20` — search only the authenticated user's library.
- `POST /api/transcripts` — submit `{ "url": "...", "lang": "auto" }`.
- `GET /api/transcripts/:id` — task status, metadata, summary, and segments.
- `GET /api/transcripts/:id/status` — lightweight task status without loading the transcript body.
- `GET /api/transcripts/:id/summary` — saved summary.
- `PUT /api/transcripts/:id/summary` — save `{ "summary": "..." }`.

Read `references/api.md` only when debugging CLI/API behavior or extending the skill. The core contract above is intentionally self-contained so an agent can install only this `SKILL.md`.

## Summary Standard

Use Markdown with these sections when the source supports them:

- **Overview** — 2–4 sentences.
- **Key points** — 3–8 bullets.
- **Notable evidence** — timestamped claims or quotes.
- **Open questions** — uncertainties, disagreements, or follow-ups.

Do not invent missing claims. Keep direct quotes short and preserve their timestamp.