# Yt

Use when YouTube is relevant: pasted video links or IDs, @handles, quick video lookups...

- Repository: https://github.com/ZeroPointRepo/youtube-skills (1151 stars)
- Category: Media
- License: MIT
- Last updated: 2026-10-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ZeroPointRepo/youtube-skills --skill yt -g -a claude-code -y`
Codex: `npx skills add ZeroPointRepo/youtube-skills --skill yt -g -a codex -y`
Cursor: `npx skills add ZeroPointRepo/youtube-skills --skill yt -g -a cursor -y`
Gemini CLI: `npx skills add ZeroPointRepo/youtube-skills --skill yt -g -a gemini-cli -y`

## Description

Use when YouTube is relevant: pasted video links or IDs, @handles, quick video lookups, summaries, channel latest uploads, topic search, or any request involving YouTube content, even if YouTube is not mentioned explicitly. Covers transcripts, search, and channel latest. Not for uploads or account management.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# yt

Quick YouTube lookup via [TranscriptAPI.com](https://transcriptapi.com).

## Setup

If `$TRANSCRIPT_API_KEY` is not set, read [references/auth-setup.md](references/auth-setup.md) and follow the instructions there to get and store the key.

## Required Headers

Every request needs two headers:

- **Authorization:** `Bearer $TRANSCRIPT_API_KEY`
- **User-Agent:** your agent's name and version if known (e.g. `HermesAgent/0.11.0`, `ClaudeCode/1.0`). Version is optional, agent name alone is fine. Do not omit this header or send a bare default, Cloudflare will return a 403 (error code 1010) and block the request.

## API Reference

Full OpenAPI spec: [transcriptapi.com/openapi.json](https://transcriptapi.com/openapi.json), consult this for the latest parameters and schemas.

## Transcript, 1 credit

```bash
curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"
```

## Search, 1 credit

```bash
curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=10" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"
```

| Param   | Default | Values                 |
| ------- | ------- | ---------------------- |
| `q`     |, | 1-200 chars (required) |
| `type`  | `video` | `video`, `channel`     |
| `limit` | `20`    | 1-50                   |

## Channel latest, FREE

```bash
curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"
```

Returns last 15 videos with exact view counts and publish dates. Accepts `@handle`, channel URL, or `UC...` ID.

## Resolve handle, FREE

The rest: https://github.com/ZeroPointRepo/youtube-skills/blob/HEAD/clawhub/yt/SKILL.md