← Back to Skills Marketplace
OpenSubtitles Read-only
by
Magolo Dennis Ooki
· GitHub ↗
· v1.0.4
411
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install opensubtitles
Description
Read-only OpenSubtitles skill to search and download subtitles via API, then extract scene context by timestamp to answer user questions regarding a show in...
Usage Guidance
This skill appears to do what it claims: it calls the OpenSubtitles API, optionally logs in to obtain a token for downloads, saves .srt files to a local cache, and extracts subtitle text around a timestamp. Before installing: (1) Understand that the skill needs your OPENSUBTITLES_API_KEY and a User-Agent string — treat the API key like any sensitive credential and don't share it; (2) if you plan to use downloads, you may need to supply username/password or a token — those are only required for login/download and are optional otherwise; (3) the scripts will create and read files under {baseDir}/storage/subtitles — ensure you are comfortable with subtitle files being stored there; (4) ensure awk is available on systems that will run subtitle-context.sh (the top-level check in one script omitted awk); (5) although this is read-only and enforces a storage-directory check to avoid arbitrary file reads, follow the guardrails (don’t log keys, don’t share tokens). If you want extra assurance, inspect/run the included scripts in a restricted environment (or review their output on a single test query) before granting the API key to an agent.
Capability Analysis
Type: OpenClaw Skill
Name: opensubtitles
Version: 1.0.4
This OpenClaw skill bundle is benign. The `SKILL.md` provides clear guardrails for the AI agent, explicitly instructing it to avoid arbitrary file access and prevent logging/exposing sensitive credentials. The `opensubtitles-api.sh` script safely constructs API requests using `jq` for URL and JSON encoding, mitigating shell injection risks. Crucially, `subtitle-context.sh` implements robust path validation, ensuring that subtitle files are only read from the designated `{baseDir}/storage/subtitles/` directory and have a `.srt` extension, preventing arbitrary file reads. There is no evidence of malicious intent, data exfiltration, or unauthorized actions.
Capability Assessment
Purpose & Capability
Name/description (OpenSubtitles read-only subtitle search/download and context extraction) match the required binaries (curl, jq, awk), the declared environment variables (API key and User-Agent), and the included scripts which call the OpenSubtitles API and extract .srt context. Optional credentials (username/password/token) are appropriate for login/download flows.
Instruction Scope
SKILL.md and the scripts keep behavior within the stated scope: API calls only target the OpenSubtitles endpoints, downloads are saved to a localized cache, subtitle reads are constrained to the storage directory, and guardrails explicitly forbid logging/exposing secrets. The agent instructions do ask it to append remaining download quota to user responses (a UI/response behavior, not an exfiltration risk).
Install Mechanism
This is an instruction-only skill with shell scripts included; there is no install spec that downloads or executes external code. No high-risk installation behavior detected.
Credentials
Requested env vars (OPENSUBTITLES_API_KEY and OPENSUBTITLES_USER_AGENT) are proportional and expected. Optional login creds/token are reasonable for download flows. Minor inconsistency: SKILL metadata lists awk as a required binary, and subtitle-context.sh uses awk, but the API script's internal dependency check only verifies curl and jq (it omits awk). This is an implementation oversight but not a malign issue.
Persistence & Privilege
The skill does not request always:true or any elevated platform privileges. It stores downloaded subtitles under its own storage path as expected and does not modify other skills or global configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install opensubtitles - After installation, invoke the skill by name or use
/opensubtitles - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
Nomenclature updates
v1.0.3
Security enhancement-stricter read paths for subtitles enforced
v1.0.1
Updated nomenclature and description
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is OpenSubtitles Read-only?
Read-only OpenSubtitles skill to search and download subtitles via API, then extract scene context by timestamp to answer user questions regarding a show in... It is an AI Agent Skill for Claude Code / OpenClaw, with 411 downloads so far.
How do I install OpenSubtitles Read-only?
Run "/install opensubtitles" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenSubtitles Read-only free?
Yes, OpenSubtitles Read-only is completely free (open-source). You can download, install and use it at no cost.
Which platforms does OpenSubtitles Read-only support?
OpenSubtitles Read-only is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenSubtitles Read-only?
It is built and maintained by Magolo Dennis Ooki (@dennisooki); the current version is v1.0.4.
More Skills