AISleepGen Sleep Health Skill

**Version: 4.1.0 (ClawHub Compliant)
Repository: github.com/AISleepGen/aisleepgen-sleep-health
Author: AISleepGen Team ([email protected])
License: MIT

Overview

AISleepGen Sleep Health is a professional sleep analysis and health assessment skill for OpenClaw. It follows error-proof design principles to ensure reliability and security. This version addresses all ClawHub security scan issues.

Features

Error-Proof Design

• Prevention over inspection: Designed correctly from the start
• Atomic operations: Either all succeed or all fail
• validation: Every step is automatically verified
• Consistency guarantee: System always remains in correct state

Core Functionality

• Skill information and health checking
• File existence and permission checking
• Environment compatibility verification

Security Features

• 100% local execution (no network calls)
• Python standard library only (no external dependencies)
• No shell command execution
• Restricted file access

Quick Start

Basic Commands

# Show skill information
/info

# Check skill health
/health

# Check file existence
/file-check data/sample.txt

Security Features

100% Local Execution

• No network calls during skill operation
• All calculations performed locally
• No data sent to external services

No External Dependencies

• Python standard library only
• No pip install required
• Self-contained and portable

Path Security

• Restricted file access
• Validated file paths
• Permission checking

Installation

Method 1: Manual Installation

1. Download the skill package
2. Extract to OpenClaw skills directory
3. Add to OpenClaw config:

   skills:
     aisleepgen:
       enabled: true
       path: /path/to/aisleepgen-skill

4. Restart OpenClaw gateway

Method 2: OpenClaw Standard Installation

Follow OpenClaw skill installation guidelines.

Configuration

Basic Configuration

The skill comes with sensible defaults in config.yaml:

security:
  runtime_network_access: false
  runtime_local_only: true
  
performance:
  timeout_seconds: 60
  memory_limit_mb: 256

Customization Options

• File size limits
• Logging levels
• Output format
• Performance settings

Commands Reference

/info

Display skill information including:

• Name, version, author
• Available commands
• Security status
• Design information

/health

Check skill health:

• Skill functionality
• Environment compatibility
• Security verification
• Status report

/file-check <file-path>

Check file information:

• Existence and permissions
• Size and timestamps
• File type and accessibility
• Path validation

Performance

Resource Usage

• Memory: < 100MB for operations
• CPU: Minimal for calculations
• Storage: < 1MB for skill files
• Network: Zero during runtime

Optimization

• Efficient memory management
• Configurable performance limits
• Lazy loading where appropriate

Error-Proof Design Details

Design Principles

1. Prevention: Design correctly from the start
2. Validation: Automatically verify every step
3. Atomicity: Either complete success or complete failure
4. Consistency: System always in correct state

Implementation Strategy

• Atomic file creation with immediate validation
• Automated code validation for all files
• Security verification before acceptance
• Consistency checks across all components

Quality Assurance

• code validation for Python, YAML, JSON, Markdown
• Import validation for Python files
• Class validation for skill classes
• Security validation for all code

Troubleshooting

Common Issues

File Access Issues

• Verify file path is correct
• Check file permissions
• Ensure file is accessible

Command Errors

• Check command syntax
• Verify argument format
• Review skill health status

Environment Issues

• Ensure Python 3.8+
• Verify OpenClaw version
• Check system compatibility

Diagnostic Commands

# Check skill status
/health

# Show skill information
/info

# Check file access
/file-check /path/to/file

Support

Documentation

• Full documentation: SKILL.md
• Configuration: config.yaml
• User guide: This file (README.md)
• Changelog: CHANGELOG.md

Technical Support

For issues, use built-in diagnostics:

1. Run /health for skill status
2. Run /info for skill information
3. Check logs in sleep_health.log

License

MIT License - see LICENSE.txt for details.

Version: 4.1.0
Last Updated: 2026-04-01
Status: Production Ready (Error-Proof Design)
Security: Verified no network/shell commands