← Back to Skills Marketplace
109
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install medical-scribe-dictation
Description
Convert physician verbal dictation into structured SOAP notes. Trigger.
Usage Guidance
What to consider before installing or running this skill:
- Privacy / PHI: This skill’s code and documentation indicate it can call external LLMs (OpenAI/Anthropic) and STT libraries. If you process patient data, assume that transcriptions or SOAP notes could be sent to third-party APIs unless you verify a local-only mode. Do not run with real PHI on third-party endpoints unless you have an explicit HIPAA-compliant contractual arrangement and have validated the endpoint’s handling of PHI.
- Missing credential declarations: The registry metadata lists no required environment variables, but requirements and SKILL.md imply use of OpenAI/Anthropic which typically need API keys (e.g., OPENAI_API_KEY, ANTHROPIC_API_KEY). Confirm which credentials the script will read before providing them.
- Review the code before use: Inspect scripts/main.py for network calls, logging, or file-write locations (where transcripts/notes are stored). The audit JSON bundled with the package reports a prior review, but you should still run python -m py_compile scripts/main.py and read the source to confirm behavior (and to find where API keys are used).
- Prefer local processing for sensitive data: If you need to process PHI, prefer local STT (faster-whisper) and local model inference or an enterprise/HIPAA-compliant hosted LLM. If using public LLM APIs, redact identifiers or obtain institutional approval.
- Dependency consistency: SKILL.md references faster-whisper (optional) but requirements.txt lists 'whisper'. Decide which STT backend you will install and adjust dependencies accordingly.
- If you lack the ability to audit code or enforce PHI protections, treat this skill as risky for real patient data. If you proceed, test with synthetic or de-identified data first and limit API credentials to least-privilege accounts.
Capability Analysis
Type: OpenClaw Skill
Name: medical-scribe-dictation
Version: 1.0.0
The skill bundle is a well-structured tool designed to convert medical dictations into SOAP notes. The Python script (scripts/main.py) implements legitimate rule-based and LLM-based parsing logic for medical vitals, medications, and clinical sections without any evidence of malicious execution (e.g., eval, os.system) or data exfiltration. While the documentation (SKILL.md) and a provided audit report (medical-scribe-dictation_audit_result_v2.json) contain some mismatched references to 'Academic Writing' (likely due to template reuse), the instructions are focused on safety, scope-bounding, and error handling rather than agent manipulation.
Capability Assessment
Purpose & Capability
The skill's stated purpose (convert physician dictation to SOAP notes) matches the included code and reference material, but the declared metadata lists no required environment variables while the SKILL.md and requirements.txt explicitly reference external LLM packages (openai, anthropic) and STT (whisper/faster-whisper). That omission is inconsistent: using those dependencies normally requires API credentials and would change risk/profile for a medical (PHI) workflow.
Instruction Scope
Runtime instructions direct users to run scripts/main.py and to rely on LLM/STT dependencies but do not provide any explicit guidance or safeguards about handling protected health information (PHI), endpoint selection, or whether external LLMs are HIPAA-compliant. The SKILL.md does not warn that transcriptions or notes may be sent to third-party APIs (OpenAI/Anthropic) nor does it provide an explicit local-only mode or redaction guidance.
Install Mechanism
There is no network download/install spec in the registry entry (instruction-only install). The package includes a requirements.txt and a Python script; no opaque remote installers or extracted archives are used. Installation risk is therefore moderate/standard for a Python package (user must pip install dependencies).
Credentials
Registry metadata claims no required env vars, yet the code and SKILL.md rely on openai/anthropic clients which typically require API keys in environment variables; requirements.txt includes openai and anthropic. The skill also references whisper/faster-whisper for audio transcription. For a medical scribe, requesting API keys for external LLM services is a significant privacy/credential concern and should be declared and justified. The package does not enumerate which environment variables (e.g., OPENAI_API_KEY, ANTHROPIC_API_KEY) will be used or provide secure/PHI-safe deployment guidance.
Persistence & Privilege
The skill does not request elevated or permanent platform privileges (always is false). It is a packaged script that reads inputs and writes outputs; there is no indication it modifies other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install medical-scribe-dictation - After installation, invoke the skill by name or use
/medical-scribe-dictation - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
medical-scribe-dictation 1.0.0
- Initial release.
- Transforms physician dictation into structured SOAP notes with normalization and clinical quality checks.
- Supports both audio (speech-to-text) and pre-transcribed text inputs.
- Outputs are customizable by specialty, format, and confidence threshold.
- Includes medical terminology handling and validation logic.
- Reference templates, parameter explanations, usage examples, and workflow documentation provided.
Metadata
Frequently Asked Questions
What is Medical Scribe (Dictation)?
Convert physician verbal dictation into structured SOAP notes. Trigger. It is an AI Agent Skill for Claude Code / OpenClaw, with 109 downloads so far.
How do I install Medical Scribe (Dictation)?
Run "/install medical-scribe-dictation" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Medical Scribe (Dictation) free?
Yes, Medical Scribe (Dictation) is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Medical Scribe (Dictation) support?
Medical Scribe (Dictation) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Medical Scribe (Dictation)?
It is built and maintained by AIpoch (@aipoch-ai); the current version is v1.0.0.
More Skills