SkillHub

medical-record-structurer

v1.3.0

Medical record structuring and standardization tool. Converts doctor's oral or handwritten medical records into standardized electronic medical records (EMR). Supports voice/text input, automatic field recognition, and structured output. Use when processing medical records, clinical notes, patient h...

Sourced from ClawHub, Authored by joe

Installation

Please help me install the skill `medical-record-structurer` from SkillHub official store. npx skills add Andyxcg/medical-record-structurer

Medical Record Structurer

Version: 1.1.0
Category: Healthcare / Medical
Billing: SkillPay (0.001 USDT per call)
Free Trial: 10 free calls per user
Demo Mode: ✅ Available (no API key required)

A professional medical record processing tool that transforms unstructured medical notes (voice or text) into standardized electronic medical records.

Features

  1. Voice/Text Input Processing - Accepts doctor's口述 or handwritten notes
  2. AI-Powered Field Extraction - Automatically identifies and extracts medical fields
  3. Standardized EMR Output - Generates structured electronic medical records
  4. Payment Integration - skillpay.me integration for monetization (0.001 USDT per use)
  5. Free Trial - 10 free calls for every new user
  6. Demo Mode - Try without API key, returns simulated data
  7. Batch Processing - Process multiple records at once
  8. File Input Support - Read medical records from files
  9. Multi-language Support - Chinese and English output

Support / 支持

If you find this skill helpful, you can support the developer:

EVM Address: 0xf8ea28c182245d9f66f63749c9bbfb3cfc7d4815

Your support helps maintain and improve this skill!

Demo Mode

Try the skill without any API key:

python scripts/process_record.py --demo

Or simply don't set any API key - the skill will automatically enter demo mode.

Demo mode returns realistic simulated medical records to demonstrate the output format.

Free Trial

Each user gets 10 free calls before billing begins. During the trial: - No payment required - Full feature access - Trial status returned in API response

{
    "success": True,
    "trial_mode": True,      # Currently in free trial
    "trial_remaining": 5,    # 5 free calls left
    "balance": None,         # No balance needed in trial
    "structured_record": {...}
}

After 10 free calls, normal billing applies.

Quick Start

Demo Mode (No API Key):

python scripts/process_record.py --demo --input "患者张三，男，45岁，主诉头痛3天..."

Process a Single Record:

from scripts.process_record import process_medical_record
import os

# Set API key via environment variable (only needed after trial)
os.environ["SKILLPAY_API_KEY"] = "your-api-key"
os.environ["SKILLPAY_SKILL_ID"] = "your-skill-id"

# Process with user_id for billing/trial tracking
result = process_medical_record(
    input_text="患者张三，男，45岁，主诉头痛3天...",
    user_id="user_123"
)

# Check result
if result["success"]:
    print("结构化病历:", result["structured_record"])
    if result.get("trial_mode"):
        print(f"免费试用剩余: {result['trial_remaining']} 次")
    else:
        print("剩余余额:", result["balance"])
else:
    print("错误:", result["error"])
    if "paymentUrl" in result:
        print("充值链接:", result["paymentUrl"])

Batch Processing:

# Process multiple files
python scripts/process_record.py --batch file1.txt file2.txt file3.txt --user-id "user_123"

from scripts.process_record import process_medical_records_batch

results = process_medical_records_batch(
    input_texts=["记录1...", "记录2...", "记录3..."],
    user_id="user_123"
)

File Input:

python scripts/process_record.py --file record.txt --user-id "user_123"

Language Selection:

# Chinese output (default)
python scripts/process_record.py --input "..." --user-id "user_123" --language zh

# English output
python scripts/process_record.py --input "..." --user-id "user_123" --language en

Environment Variables

This skill requires the following environment variables:

Required Variables (After Trial)

Variable Description Required Example
SKILLPAY_API_KEY Your SkillPay API key for billing After trial skp_abc123...
SKILLPAY_SKILL_ID Your Skill ID from SkillPay dashboard After trial skill_def456...

Optional Variables

Variable Description Default
OCR_API_KEY API key for OCR services (image processing) -
OCR_PROVIDER OCR provider (google, azure, aws, tesseract) google
STT_API_KEY API key for speech-to-text services -
STT_PROVIDER STT provider (google, azure, aws, whisper) whisper
PHI_ENCRYPTION_KEY Encryption key for PHI protection -
DATA_RETENTION_DAYS Days to retain processed records 30
AUDIT_LOGGING_ENABLED Enable audit logging true

See .env.example for a complete list of environment variables.

Configuration

The skill uses SkillPay billing integration: - Provider: skillpay.me - Price: 0.001 USDT per request - Chain: BNB Chain - Free Trial: 10 calls per user - Demo Mode: Available without API key - API Key: Set via SKILLPAY_API_KEY environment variable - Skill ID: Set via SKILLPAY_SKILL_ID environment variable

Output Format

Structured medical record includes: - Patient demographics (name, age, gender) - Chief complaint - History of present illness - Past medical history - Physical examination - Diagnosis - Treatment plan - Medications - Follow-up instructions

Response Format

{
    "success": True,
    "demo_mode": False,         # True if in demo mode
    "trial_mode": False,        # True during free trial
    "trial_remaining": 0,       # Remaining free calls
    "balance": 95.5,            # User balance (None during trial/demo)
    "structured_record": {
        "emr_version": "1.0",
        "record_id": "EMR_20240306120000",
        "record_date": "2024-03-06T12:00:00",
        "patient_demographics": {...},
        "clinical_information": {...},
        "assessment_and_plan": {...},
        "metadata": {...}
    }
}

PHI and Privacy Handling

This skill processes Protected Health Information (PHI). The following safeguards are implemented:

Data Protection

  • Encryption: All data is encrypted at rest and in transit
  • Access Control: User authentication required for all operations
  • Audit Logging: All access to PHI is logged
  • Data Minimization: Only necessary fields are extracted and stored

Compliance

  • HIPAA Considerations: Designed with HIPAA safeguards in mind
  • GDPR: Supports data deletion requests
  • Retention: Configurable data retention policies (default: 30 days)

Best Practices

  1. Always use environment variables for sensitive configuration
  2. Enable audit logging in production
  3. Implement proper access controls
  4. Regular security reviews recommended

OCR/STT Support

This skill supports external OCR and STT services:

OCR (Optical Character Recognition)

For processing handwritten or scanned medical records: - Google Vision API - Azure Computer Vision - AWS Textract - Tesseract (open source)

STT (Speech-to-Text)

For processing voice-recorded medical notes: - Google Speech-to-Text - Azure Speech Services - AWS Transcribe - OpenAI Whisper (open source)

Configure the respective API keys in your .env file to enable these features.

References

  • For detailed field specifications: see references/emr-schema.md
  • For payment API details: see references/skillpay-api.md
  • For full documentation: see README.md

Changelog

v1.1.0

  • Added demo mode (no API key required)
  • Added batch processing support
  • Added file input support
  • Added multi-language support (zh/en)
  • Unified environment variable naming to SKILLPAY_API_KEY and SKILLPAY_SKILL_ID
  • Improved error messages with bilingual support

v1.0.4

  • Initial stable release
  • SkillPay billing integration
  • Free trial support