Kai Skill Creator

Create OpenClaw skills correctly. Learned from getting kai-minimax-tts and kai-skill-creator to pass ClawHub scan.

Quick Start

1. Clone Template

2. Edit SKILL.md

CORRECT FRONTMATTER:
CODEBLOCK1

3. Write Script

4. Validate

5. Copy to Global

6. Register in Config

7. Publish

cd ~/.openclaw/workspace
npx clawhub publish skills/<SKILL_NAME> --slug <SKILL_NAME> --version 1.0.0 --tags "tag1,tag2"

⚠️ CRITICAL: What NOT to Do

❌ NEVER Hardcode API Keys

❌ NEVER Load .env in Script

❌ NEVER Use homepage Key

❌ NEVER Mention External API URLs

# FLAGGED! External endpoint reference
Get key from: https://api.example.com

❌ NEVER Leave Env Vars Undeclared

❌ Script Syntax Errors

# Test your script before publishing!
bash script.sh --test
# If EOF error or syntax issues → FLAGGED

✅ The CORRECT Pattern

Declaring Requirements

Using Env Vars (Auto-Injected)

Adding Secrets to Config

{
  "skills": {
    "entries": {
      "my-skill": {
        "enabled": true,
        "env": {
          "API_KEY": "actual_key_here"
        }
      }
    }
  }
}

Scanner Checks (What Gets Flagged)

The ClawHub scanner verifies:

1. 1. Coherence: Declared requirements match actual code
2. No surprise permissions: Env vars/bins declared = actually used
3. No data exfiltration: External URLs in docs = red flag
4. Valid syntax: Scripts must parse without errors
5. Purpose clarity: Description matches what code actually does

Green = purpose, permissions, and code all match.

Pre-Publish Checklist

• - [ ] No API keys hardcoded anywhere
• [ ] No .env loading statements
• [ ] All env vars declared in INLINECODE2
• [ ] All bins declared in INLINECODE3
• [ ] No homepage key
• [ ] No external API URLs in docs
• [ ] Script has valid syntax (test it!)
• [ ] Script produces expected output
• [ ] Version bumped (1.0.0 → 1.0.1 → etc)
• [ ] Validated with quick_validate.py

Troubleshooting

Testing Tips

Test script locally:

# With inline env var for testing
MINIMAX_API_KEY=test_key bash scripts/script.sh --speak "test" en

# Check syntax
bash -n scripts/script.sh

File Locations