skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
felo-inc/felo-skills92 installs

felo-youtube-subtitling

Fetch YouTube video subtitles/captions using Felo YouTube Subtitling API. Use when users ask to get YouTube subtitles, extract captions from a video, fetch transcript by video ID or URL, or when explicit commands like /felo-youtube-subtitling are used. Supports language and optional timestamps.

How do I install this agent skill?

npx skills add https://github.com/felo-inc/felo-skills --skill felo-youtube-subtitling
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is generally safe for use. A low-severity risk of indirect prompt injection was identified because the skill fetches and processes untrusted external content (YouTube subtitles) without explicit boundary markers or sanitization.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

  • Runlayerpass

    1/3 files flagged

What does this agent skill do?

Felo YouTube Subtitling Skill

When to Use

Trigger this skill when the user wants to:

  • Get subtitles or captions from a YouTube video
  • Extract transcript by video ID or video URL
  • Fetch subtitles in a specific language (e.g. en, zh-CN)
  • Get subtitles with timestamps for analysis or translation

Trigger keywords (examples):

  • YouTube subtitles, get captions, video transcript, extract subtitles, YouTube 字幕
  • Explicit: /felo-youtube-subtitling, "use felo youtube subtitling"

Do NOT use for:

  • Real-time search (use felo-search)
  • Web page content (use felo-web-fetch)
  • Generating slides (use felo-slides)

Setup

1. Get API key

  1. Visit felo.ai
  2. Open Settings -> API Keys
  3. Create and copy your API key

2. Configure environment variable

Linux/macOS:

export FELO_API_KEY="your-api-key-here"

Windows PowerShell:

$env:FELO_API_KEY="your-api-key-here"

How to Execute

Option A: Use the bundled script or packaged CLI

Script (from repo):

node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs --video-code "dQw4w9WgXcQ" [options]

Packaged CLI (after npm install -g felo-ai):

felo youtube-subtitling -v "dQw4w9WgXcQ" [options]
# Short forms: -v (video-code), -l (language), -j (json)

Options:

OptionDefaultDescription
--video-code / -v(required)YouTube video URL or video ID (e.g. https://youtube.com/watch?v=ID or dQw4w9WgXcQ)
--language / -l-Subtitle language code (e.g. en, zh-CN)
--with-timefalseInclude start/duration timestamps in each segment
--json / -jfalsePrint full API response as JSON

You can pass either a full YouTube link or the 11-character video ID:

  • Supported URLs: https://www.youtube.com/watch?v=ID, https://youtu.be/ID, https://youtube.com/embed/ID
  • Or plain ID: dQw4w9WgXcQ

Examples:

# With video URL
node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs --video-code "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
felo youtube-subtitling -v "https://youtu.be/dQw4w9WgXcQ"

# With video ID
node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs -v "dQw4w9WgXcQ" --language zh-CN

# With timestamps
node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs -v "dQw4w9WgXcQ" --with-time --json

Option B: Call API with curl

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ" \
  -H "Authorization: Bearer $FELO_API_KEY"

API Reference (summary)

  • Endpoint: GET /v2/youtube/subtitling
  • Base URL: https://openapi.felo.ai. Override with FELO_API_BASE env if needed.
  • Auth: Authorization: Bearer YOUR_API_KEY

Query parameters

ParameterTypeRequiredDefaultDescription
video_codestringYes-YouTube video ID (e.g. dQw4w9WgXcQ)
languagestringNo-Language code (e.g. en, zh-CN)
with_timebooleanNofalseInclude start/duration per segment

Response (200)

{
  "code": 0,
  "message": "success",
  "data": {
    "title": "Video title",
    "contents": [
      { "start": 0.32, "duration": 14.26, "text": "Subtitle text" }
    ]
  }
}

With with_time=false, start/duration may be absent or zero. contents[].text is always present.

Error codes

HTTPCodeDescription
400-Parameter validation failed (e.g. missing video_code)
401INVALID_API_KEYAPI key invalid or revoked
500/502YOUTUBE_SUBTITLING_FAILEDService error or subtitles unavailable for video

Output Format

  • Without --json: print title and then each segment's text (one per line or concatenated). If --with-time, output includes timestamps.
  • With --json: print full API response.

On failure (no subtitles, API error): stderr message and exit 1. Example:

YouTube subtitling failed for video dQw4w9WgXcQ: YOUTUBE_SUBTITLING_FAILED

Important Notes

  • Not all videos have subtitles; the API may return an error for some videos.
  • Language code must match a subtitle track available for the video.
  • Same FELO_API_KEY as other Felo skills.

References

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/felo-inc/felo-skills/felo-youtube-subtitling">View felo-youtube-subtitling on skillZs</a>