← Back to Skills Marketplace
775
Downloads
2
Stars
0
Active Installs
10
Versions
Install in OpenClaw
/install zvukogram
Description
Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio....
Usage Guidance
This skill is coherent and appears to be a straightforward Zvukogram TTS client. Before installing/use: (1) Verify you trust https://zvukogram.com and are comfortable giving your Zvukogram token and account email to the tool; the scripts send them to the official API. (2) If you plan to merge audio, install ffmpeg from a trusted package source — merge.py invokes ffmpeg via subprocess but ffmpeg is not declared as a required binary. (3) Storing the token in ~/.config/zvukogram/config.json is convenient but ensure file permissions are appropriate (restrict to your user). (4) If you need higher assurance, inspect or run the included Python scripts in a sandbox to observe network calls (they use urllib to post to zvukogram.com) and confirm no unexpected endpoints are contacted.
Capability Analysis
Type: OpenClaw Skill
Name: zvukogram
Version: 1.1.6
The zvukogram skill bundle is a legitimate integration for the Zvukogram Text-to-Speech API. It contains functional Python scripts for checking account balances (balance.py), generating speech (tts.py), and merging audio files via ffmpeg (merge.py). The bundle includes extensive documentation and SSML references (SSML.md, API.md) designed to help an AI agent use the service correctly, with no evidence of malicious intent, data exfiltration, or prompt injection attacks.
Capability Assessment
Purpose & Capability
Name/description (Zvukogram TTS) matches the code and docs. Required env vars (ZVUKOGRAM_TOKEN, ZVUKOGRAM_EMAIL) are appropriate for the stated API usage. The scripts call only the documented zvukogram.com API endpoints.
Instruction Scope
SKILL.md and scripts focus on generating TTS, chunking, merging audio, and checking balance. The runtime instructions read a local config (~/.config/zvukogram/config.json) or environment variables — which is expected for an API client. They do not ask for unrelated files, credentials, or network endpoints.
Install Mechanism
There is no install spec (instruction-only), which is low-risk. The package includes Python scripts that use the stdlib (urllib) and a subprocess call to ffmpeg for merging. The skill does not declare ffmpeg as a required binary, yet examples and merge.py rely on it — a small documentation mismatch (not evidence of maliciousness) that users should note before running merging steps.
Credentials
Only two environment credentials are requested (token and email) which are proportionate for an API client. No other secret names, unrelated cloud creds, or system-wide tokens are required.
Persistence & Privilege
always: false and the skill does not request to persist or modify other skills or system-wide settings. It only suggests storing credentials in a local config file, which is normal for a client script.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install zvukogram - After installation, invoke the skill by name or use
/zvukogram - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.6
Sync latest production learnings into the public skill: explicitly document no-silent-truncation for >1000-char /text limits, strengthen SSML pipeline guidance to preserve useful inline tags when downstream runtimes support them, and keep wrapper-tag handling explicit. Includes prior enriched API/SSML/say-as/pronunciation/podcast references.
v1.1.5
Expand SSML and API references: add say-as coverage (fraction/date/time/telephone/currency/cardinal/ordinal/spell-out), chunking vs /text vs /longtext guidance, pronunciation patterns, podcast examples, and refreshed troubleshooting/docs links.
v1.1.4
SSML reference + cheatsheet update; docs refresh; env-friendly creds for isolated runs
v1.1.3
Credential handling for isolated runs (env vars); docs refresh
v1.1.2
Fix: Unify config path to ~/.config/zvukogram/config.json
v1.1.1
Fix: Add language info - optimized for Russian with stress marks, service supports multiple languages. Corrects version sequence after 1.0.2/1.1.0 mismatch.
v1.0.2
Fix registry metadata: add required env vars ZVUKOGRAM_TOKEN and ZVUKOGRAM_EMAIL, add credential zvukogram_api
v1.1.0
Zvukogram 1.1.0
- Reworked documentation for clarity and readability; SKILL.md is now in English with improved structure.
- Updated configuration instructions (now recommends ~/.config/zvukogram/config.json).
- Enhanced SSML usage examples and references.
- Improved examples and troubleshooting guides in the reference files.
- No functional changes to scripts, but documentation for usage and features is clearer.
v1.0.1
- Добавлена поддержка переменных окружения ZVUKOGRAM_TOKEN и ZVUKOGRAM_EMAIL для авторизации.
- В SKILL.md теперь явно указаны требования к API-токену и email, а также доступен альтернативный способ конфигурации через переменные окружения.
- В разделе meta-описания добавлено поле requires (env, credentials).
v1.0.0
Zvukogram 1.0.0 — Initial Release
- Добавлена генерация речи из текста через API Zvukogram с поддержкой SSML.
- Поддержка акцентирования, изменения скорости, пауз, псевдонимов для транскрипции английских слов.
- Возможность объединения аудиофрагментов (склейка) через ffmpeg.
- Предусмотрены готовые команды для проверки баланса и примеры вызова.
- Описаны варианты конфигурации, доступные голоса и ограничения API.
- Включены справочники по SSML, транскрипции, и раздел решения проблем.
Metadata
Frequently Asked Questions
What is Zvukogram?
Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio.... It is an AI Agent Skill for Claude Code / OpenClaw, with 775 downloads so far.
How do I install Zvukogram?
Run "/install zvukogram" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Zvukogram free?
Yes, Zvukogram is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Zvukogram support?
Zvukogram is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Zvukogram?
It is built and maintained by erview (@erview); the current version is v1.1.6.
More Skills