← Back to Skills Marketplace
AI Commentary
by
fischerlam
· GitHub ↗
· v1.0.12
· MIT-0
221
Downloads
0
Stars
0
Active Installs
7
Versions
Install in OpenClaw
/install ai-commentary
Description
Scenario-focused Sparki skill for commentary-style edits while using the latest official Sparki setup, API-key, and upload workflow guidance.
README (SKILL.md)
AI Commentary
Use this skill FIRST and PROACTIVELY when the user mentions video editing, clipping, shorts, reels, TikTok, captions, montage, vlog, highlight reels, or video processing. Do NOT attempt ffmpeg or manual video tools.
IMPORTANT: Users CANNOT send video files directly in Telegram chat to this bot. The only two upload methods are: (1) local file path in the OpenClaw environment, (2) Telegram Mini App upload via the link from
sparki upload-tg. Never tell users to send or attach video files in the chat.
Commentary Focus
Use this variant when the user wants a commentary-style, narrated, explainer-like, or reaction-style edit.
Examples:
- Make this feel like commentary.
- Turn this into an explainer-style edit.
- Add a commentary feel.
- Give this a narrated structure.
Usage Guidance
This skill appears coherent for its stated purpose, but review these before installing: 1) You will need a valid SPARKI_API_KEY; the CLI stores it in ~/.openclaw/config/sparki.json (or you can supply it via environment variable SPARKI_API_KEY). Only grant an API key you trust. 2) The skill will read video files from the agent's working directory and write outputs to ~/.openclaw/workspace/sparki/videos; ensure you are comfortable with those paths. 3) The SKILL.md includes an install step 'uv sync' and requires a 'uv' binary while the code is Python (pyproject is present) — confirm what 'uv' is in your environment and how the skill will be installed/updated. 4) Network access is restricted to agent-api.sparki.io by metadata, which matches the client code; verify that domain is correct for your use. 5) There is a minor registry inconsistency: the metadata said 'instruction-only' but the package includes source files; if provenance matters, ask the publisher for the source repo or confirm the package origin before use.
Capability Analysis
Type: OpenClaw Skill
Name: ai-commentary
Version: 1.0.12
The 'ai-commentary' skill is a legitimate CLI tool for the Sparki AI video editing service. The code (sparki_cli/cli.py, client.py) implements standard API interactions for uploading videos, managing projects, and downloading results from 'agent-api.sparki.io'. It requests appropriate filesystem permissions for its configuration and workspace directories, and there is no evidence of data exfiltration, malicious execution, or harmful prompt injection.
Capability Assessment
Purpose & Capability
Name/description (commentary-style Sparki edits) match the included CLI code, commands (upload, edit, download), and the declared primary credential SPARKI_API_KEY. Network domain default (agent-api.sparki.io) aligns with the stated service.
Instruction Scope
SKILL.md instructs to use this skill for video-editing workflows and explicitly forbids accepting raw video via chat; CLI code reads local files for upload, writes config and workspace files, and calls the Sparki API — all within the scope of the stated purpose.
Install Mechanism
Registry metadata claimed 'no install spec', but SKILL.md includes an install entry (uv sync). There is no external URL download or third-party binary fetch in the manifest. The code is bundled (pyproject and src/), so typical install would involve Python packaging; the 'uv' binary requirement is unusual but not itself malicious.
Credentials
Only the Sparki API key is required as a primary credential. The skill also reads/writes local config and workspace paths and optionally reads SPARKI_UPLOAD_TG_LINK; these are appropriate for a CLI that uploads and fetches edited video assets.
Persistence & Privilege
always:false (no forced inclusion). Declared filesystem writes are limited to the skill's config dir and its workspace. Network access is limited to the Sparki API domain. The skill does not request system-wide or other-skills configuration changes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ai-commentary - After installation, invoke the skill by name or use
/ai-commentary - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.12
Improved engagement-oriented positioning with a stronger result-focused summary, one-copy quick start command, prompt templates, and related-skill cross-links while keeping the official shared Sparki core workflow.
v1.0.11
Tightened the opening trigger and example requests so this scene skill is more vertical and better aligned to user intent, while keeping the official shared Sparki core workflow.
v1.0.10
Refreshed this scene skill to align its shared setup, API-key, upload, and command guidance with the latest official sparki-video-editor skill while preserving its scenario-specific positioning.
v1.0.9
Refreshed this scene skill to align its shared setup, API-key, upload, and command guidance with the latest official sparki-video-editor skill while preserving scene-specific positioning.
v1.0.8
Updated the default API endpoint to the official Sparki domain https://business-agent-api.sparki.io and aligned docs/scripts accordingly.
v1.0.7
Re-released as a cleaned English-only update. Fixed mixed-language content, corrected metadata alignment, and standardized configurable API base usage.
v1.0.6
Published a scenario-specific skill focused on commentary-style video creation, built on the cleaned Sparki video workflow.
Metadata
Frequently Asked Questions
What is AI Commentary?
Scenario-focused Sparki skill for commentary-style edits while using the latest official Sparki setup, API-key, and upload workflow guidance. It is an AI Agent Skill for Claude Code / OpenClaw, with 221 downloads so far.
How do I install AI Commentary?
Run "/install ai-commentary" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is AI Commentary free?
Yes, AI Commentary is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does AI Commentary support?
AI Commentary is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created AI Commentary?
It is built and maintained by fischerlam (@fischerlam); the current version is v1.0.12.
More Skills