← Back to Skills Marketplace
lyla0921

Voice To Protocol Transcriber

by Lyla0921 · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ⚠ suspicious
269
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install voice-to-protocol-transcriber
Description
Record experimental procedures and observations via voice commands during lab work. Real-time transcription for structured experiment documentation.
Usage Guidance
What to check before installing: - Dependency mismatch: SKILL.md asks you to install speechrecognition, pyaudio, pydub, python-docx but requirements.txt does not include them. Expect to manually install the missing packages (use a virtualenv). Verify the skill runs after installing exactly what it needs. - Network/privacy risk: The speechrecognition library typically uses online services by default (for example, Google Web Speech API). Confirm whether the code uses an offline recognizer or sends audio to external servers. If the code calls cloud recognizers, audio (potentially sensitive experimental data) may leave your machine. Ask the author or inspect the full main.py to see how Recognition is configured. - Inspect the rest of main.py: only a truncated portion was provided. Review the remainder for any hard-coded endpoints, hidden subprocess/network calls, or unexpected file access before trusting this in regulated labs. - Install safely: install inside a virtual environment on a non-production/test machine first. Run with microphone permissions in an isolated environment. Check that saved files go to a directory you control and do not inadvertently overwrite other files. - Operational caution: don't run this against sensitive or PHI-containing experiments until you confirm where audio/text is processed (locally vs. remote) and audit third-party dependencies. If you can provide the full main.py (untruncated) or confirm whether speech recognition is configured for an offline engine, I can raise or lower the confidence and give more specific advice.
Capability Analysis
Type: OpenClaw Skill Name: voice-to-protocol-transcriber Version: 0.1.0 The skill contains a path traversal vulnerability in `scripts/main.py`, where the `experiment_name` input is used to construct file paths without sanitizing directory traversal sequences (e.g., `../`), potentially allowing files to be written outside the intended directory. Additionally, there is a significant discrepancy between `SKILL.md`, which claims to support real-time voice recognition and requires external libraries like `pyaudio`, and the actual implementation in `scripts/main.py`, which is a basic text-only logger using standard libraries. While no clear evidence of malicious intent was found, the combination of a file-writing vulnerability and misleading documentation warrants a suspicious classification.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md and the included Python code all align with a voice-driven experiment recorder that saves files to the user's Documents directory. However, SKILL.md lists external Python packages (speechrecognition, pyaudio, pydub, python-docx) while the included requirements.txt only contains 'dataclasses', 'enum', and 'wave' — a clear mismatch. Also the bundle contains code but no install spec, which is inconsistent with the advertised dependency installation steps.
Instruction Scope
SKILL.md says 'No external API calls' in the risk table, yet it recommends the 'speechrecognition' package and notes Chinese recognition needs a good network connection. The speechrecognition library commonly uses cloud/online recognizers (e.g., Google) unless explicitly configured for an offline engine; this can send audio to third-party servers. The instructions otherwise operate on local files and a local config path (~/.openclaw/...), which is expected for the stated purpose.
Install Mechanism
There is no install spec in the registry (instruction-only), yet the package includes executable Python code and a requirements.txt that does not reflect the SKILL.md 'pip install' list. This mismatch may lead to missing runtime dependencies or hidden manual install steps. No remote download URLs are present in files examined, which reduces high-risk install behavior, but the missing/incorrect dependency declarations are a practical risk.
Credentials
The skill requests no environment variables or credentials and only reads/writes local files (default save dir ~/Documents/Experiment-Protocols or ~/.openclaw config). That is proportionate for a local transcription tool. Users should note audio data and saved protocol files may contain sensitive lab data.
Persistence & Privilege
No elevated privileges requested, always=false, and the skill does not declare modifications to other skills or global agent settings. It writes its own config under ~/.openclaw and saves files to a user-owned Documents folder — expected for this functionality.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install voice-to-protocol-transcriber
  3. After installation, invoke the skill by name or use /voice-to-protocol-transcriber
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release: Voice-to-Protocol Transcriber enables real-time, voice-driven experiment documentation. - Supports real-time transcription and structured documentation of lab steps and observations via voice commands. - Provides multi-language support (Chinese and English). - Automatically classifies and timestamps experiment steps, observations, and notes. - Allows saving experiment records in Markdown and Word formats. - Includes voice command control for hands-free operation.
Metadata
Slug voice-to-protocol-transcriber
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Voice To Protocol Transcriber?

Record experimental procedures and observations via voice commands during lab work. Real-time transcription for structured experiment documentation. It is an AI Agent Skill for Claude Code / OpenClaw, with 269 downloads so far.

How do I install Voice To Protocol Transcriber?

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

Is Voice To Protocol Transcriber free?

Yes, Voice To Protocol Transcriber is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Voice To Protocol Transcriber support?

Voice To Protocol Transcriber is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Voice To Protocol Transcriber?

It is built and maintained by Lyla0921 (@lyla0921); the current version is v0.1.0.

💬 Comments