clawhub-publish-mai
v1.0.0Publish OpenClaw skills to ClawHub marketplace (clawhub.ai). Use when deploying a skill to ClawHub for the first time, updating an existing published skill, or when user says "스킬 배포", "ClawHub에 올려줘", "publish skill", "스킬 퍼블리시", "ClawHub publish". Handles language check (Korean → English), personal i...
Installation
ClawHub Publish
Prerequisites
- clawhub CLI installed:
npm i -g clawhub - Logged in:
clawhub whoami(if not:clawhub loginvia PTY + browser) - Target skill folder exists under
C:MAIBOTskills<skill-name>
Workflow
1. Pre-publish Checklist
Run against each skill before publishing. See references/checklist.md for full criteria.
Quick scan:
Get-Content "C:MAIBOTskills<skill-name>SKILL.md" -Encoding UTF8 | Select-Object -First 40
Must verify:
- [ ] description: field is in English (this is what ClawHub users see first)
- [ ] No Korean text in SKILL.md body
- [ ] No personal paths (C:Usersjini9, JINI_SYNC, etc.)
- [ ] No internal account names or credentials
- [ ] Generic placeholders used where personal config appeared
2. Language & Sanitization Fix
If Korean or personal info is found:
1. Rewrite SKILL.md fully in English
2. Replace personal paths with generic placeholders ($VAULT_PATH, ~/vault, your-username)
3. Move any references/*.md content to English as well
4. Write with UTF-8: [System.IO.File]::WriteAllText($path, $content, [System.Text.Encoding]::UTF8)
3. Determine Version
| Scenario | Version bump |
|---|---|
| First publish | 1.0.0 |
| Content fix / translation | 1.1.0 (minor) |
| New section / major rewrite | 2.0.0 (major) |
| Typo / small fix | 1.0.1 (patch) |
4. Publish
cd C:MAIBOT
clawhub publish ./skills/<skill-name> `
--slug <slug> `
--name "<Display Name>" `
--version <X.Y.Z> `
--changelog "<one-line summary of changes>"
Slug rules:
- Lowercase, hyphens only
- Must be globally unique on ClawHub
- If slug taken: append -mai suffix (e.g., obsidian-daily-mai)
5. Verify
clawhub whoami # confirm still authenticated
# Then check: https://clawhub.ai/u/jini92
6. Update Records
After successful publish, update both:
- C:MAIBOTmemorymarketplace-strategy.md — add row to ClawHub table
- Obsidian _DASHBOARD.md — add to Current Sprint as Done
Batch Publish
To publish multiple skills at once, run steps 1–4 for each in sequence.
Check references/checklist.md for the full quality bar before each.
Common Errors
| Error | Fix |
|---|---|
Not logged in |
Run clawhub login in PTY mode; open browser URL when shown |
Only the owner can publish updates |
Slug taken by another user; add -mai suffix |
Login session timeout (code 1) |
Rerun clawhub login — PTY must stay alive until browser auth completes |