← 返回 Skills 市场
OpenSubtitles Read-only
作者
Magolo Dennis Ooki
· GitHub ↗
· v1.0.4
411
总下载
0
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install opensubtitles
功能描述
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...
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install opensubtitles - 安装完成后,直接呼叫该 Skill 的名称或使用
/opensubtitles触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 411 次。
如何安装 OpenSubtitles Read-only?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install opensubtitles」即可一键安装,无需额外配置。
OpenSubtitles Read-only 是免费的吗?
是的,OpenSubtitles Read-only 完全免费(开源免费),可自由下载、安装和使用。
OpenSubtitles Read-only 支持哪些平台?
OpenSubtitles Read-only 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 OpenSubtitles Read-only?
由 Magolo Dennis Ooki(@dennisooki)开发并维护,当前版本 v1.0.4。
推荐 Skills