skilld
All skills
zeropointrepo avatar

/yt

@44ce45d
by Zero Point Studiozeropointrepo/youtube-skills987 stars
110

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.

Ask your Agent

Use this Skill: https://skilld.dev/gh/zeropointrepo/youtube-skills/yt

This session only. Nothing lands on disk.

SKILL.md

≈79 tokens always: the name and description. ≈699 when used: this file. ≈2.1k more on demand in 2 files.

yt

Quick YouTube lookup via TranscriptAPI.com.

Setup

If $TRANSCRIPT_API_KEY is not set, read 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 — consult this for the latest parameters and schemas.

Transcript — 1 credit

GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Search — 1 credit

GET https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=10
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
Param Default Values
q — 1-200 chars (required)
type video video, channel
limit 20 1-50

Channel latest — FREE

GET https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
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

GET https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

Use to convert @handle to UC... channel ID.

Errors

Code Meaning Action
401 Bad API key Check key
402 No credits transcriptapi.com/billing
403/1010 Cloudflare block Add or fix User-Agent header
404 Not found No captions or resource doesn't exist
408 Timeout Retry once

Free tier: 100 credits. Search and transcript cost 1 credit. Channel latest and resolve are free.

Copy-paste examples

Every request in this file as a ready-to-run one-liner: references/curl-examples.md

Source: SKILL.md on GitHub

Third-party checks

1 alert10d5 checks · Risk MEDIUM
  • Gen Agent Trust Hub10d

    The skill provides YouTube transcript and search capabilities but includes concerning instructions for credential management. It directs the agent to modify system-level shell profiles for persistence and explicitly instructs the agent to bypass security redaction filters by using temporary files to hide API tokens and keys from the environment's logging and safety systems.

  • Socket10d

    1 alert: gptMalware

  • Snyk10d

    Risk: MEDIUM · 2 issues

  • Runlayer7mo

    2/2 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 44ce45d. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated last week

Capability

version
1.5.2
user-invocable
true
Other metadata
compatibility
Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed.
required_environment_variables
[
  {
    "name": "TRANSCRIPT_API_KEY",
    "prompt": "Your TranscriptAPI key (starts with sk_)",
    "help": "Free account at https://transcriptapi.com — 100 credits, no card required. Or let the agent create one for you.",
    "required_for": "all API requests"
  }
]
metadata
{
  "openclaw": {
    "emoji": "▶️",
    "requires": {
      "env": [
        "TRANSCRIPT_API_KEY"
      ]
    },
    "primaryEnv": "TRANSCRIPT_API_KEY",
    "homepage": "https://transcriptapi.com"
  },
  "hermes": {
    "tags": [
      "youtube",
      "transcripts",
      "video",
      "search",
      "channels",
      "utility"
    ],
    "category": "media"
  }
}

README badge

README badge for zeropointrepo/youtube-skills/yt