← Back to Skills Marketplace
poltawa

subtitle-extractor

by poltawa · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
101
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install subtitle-extractor
Description
Subtitle extractor for Bilibili, YouTube, Xiaohongshu, Douyin, and local files. Extracts native subtitles or Whisper transcription in original format. Agent...
Usage Guidance
This skill appears to implement subtitle extraction and optional Whisper transcription, but review these issues before installing: - Cookie handling: the SKILL.md claim that cookies are "never transmitted externally" is incorrect — cookies passed to yt-dlp are used for network requests and will reach the video service. Do not place sensitive cookies in the skill directory unless you understand the exposure. - Mandatory pre-run: the skill requires Steps 1–4 to run before responding. That can trigger network access and large model downloads even if the user's request doesn't need them. If you want to avoid unexpected network activity, run in an isolated environment or require explicit user approval before extraction/transcription. - Missing/unclear requirements: ffmpeg and the faster-whisper Python package (and optionally modelscope) are required for transcription flows but are not listed in the registry metadata. Ensure you install/verify these tools first. - Runtime downloads: transcription may auto-download Whisper models (~150MB for base); this consumes bandwidth and disk. Consider setting VIDEO_SUMMARY_WHISPER_MODEL to a vetted local model directory to avoid automatic downloads. - File discovery: the script auto-discovers any *.txt with 'bilibili' in the skill directory. Keep that directory free of unrelated cookie files. If these behaviors are acceptable, proceed; otherwise request the author clarify the manifest (declare ffmpeg/faster-whisper env vars) and remove the misleading security statement about cookie transmission.
Capability Analysis
Type: OpenClaw Skill Name: subtitle-extractor Version: 1.0.0 The skill is a legitimate subtitle extraction and transcription tool that utilizes well-known utilities like yt-dlp and faster-whisper. The Python script (subtitle-extractor.py) implements secure subprocess handling using lists to prevent shell injection and limits cookie access to the local skill directory. The instructions in SKILL.md are strictly aligned with the stated functionality, providing clear error handling and dependency management without any evidence of data exfiltration, persistence, or malicious prompt injection.
Capability Assessment
Purpose & Capability
The name/description match the code: it uses yt-dlp for native subtitles and faster-whisper/ffmpeg for transcription. However the registry metadata only lists yt-dlp as a required binary while the SKILL.md and script clearly require ffmpeg (for transcription) and the Python faster-whisper package. That mismatch between declared requirements and actual runtime needs is inconsistent.
Instruction Scope
SKILL.md forcefully requires running Steps 1–4 before answering user requests (non-negotiable), which can trigger network access, model downloads, and reading local cookie files even when not necessary. The SKILL.md claims cookie files are "read locally only, never transmitted externally," but the script passes cookies to yt-dlp for network requests (so cookie data will be sent to remote services). The script also auto-discovers any *.txt with 'bilibili' in its filename in the skill directory, which could pick up unintended cookie files.
Install Mechanism
There is no install spec (instruction-only), but the included Python script performs runtime downloads (Whisper models via faster-whisper/HuggingFace or ModelScope through modelscope), which will fetch ~100s of MBs of model data and write them to disk. Runtime downloads are not flagged in a manifest and may require network access and storage.
Credentials
The registry declares no required env vars, but SKILL.md and the script read/use VIDEO_SUMMARY_WHISPER_MODEL and reference VIDEO_SUMMARY_COOKIES. These env vars can change behavior (point to local models or cookie paths). The skill reads files from its directory and may write model files and outputs under the skill folder; the use of env vars and file discovery is not declared in the metadata.
Persistence & Privilege
The skill is not marked always:true and does not request platformwide privileges. It writes models and outputs to its own skill directory and does not modify other skills or system-wide agent settings. Autonomous invocation is allowed (platform default) but not combined with 'always'.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install subtitle-extractor
  3. After installation, invoke the skill by name or use /subtitle-extractor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Subtitle Extractor 1.0.0 – Initial Release - Extracts subtitles from Bilibili, YouTube, Xiaohongshu, Douyin, and local files. - Supports both native subtitle extraction and Whisper transcription fallback. - Handles dependency checks (yt-dlp, ffmpeg, faster-whisper) and provides user guidance for missing components. - Manages Bilibili cookies securely via auto-discovery in the skill directory. - Outputs subtitle file path, video title, and author; agent saves and processes per user request.
Metadata
Slug subtitle-extractor
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is subtitle-extractor?

Subtitle extractor for Bilibili, YouTube, Xiaohongshu, Douyin, and local files. Extracts native subtitles or Whisper transcription in original format. Agent... It is an AI Agent Skill for Claude Code / OpenClaw, with 101 downloads so far.

How do I install subtitle-extractor?

Run "/install subtitle-extractor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is subtitle-extractor free?

Yes, subtitle-extractor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does subtitle-extractor support?

subtitle-extractor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created subtitle-extractor?

It is built and maintained by poltawa (@poltawa); the current version is v1.0.0.

💬 Comments