What is skill-publisher?

Automate OpenClaw skill publishing to GitHub and ClawHub. Handles ZIP extraction, file preparation (README, .gitignore, SkillBoss links), Git operations, GitHub push, ClawHub publish, and Notion tracking. Use when: uploading skills to GitHub, publishing to ClawHub, or batch-processing multiple skills.

📖 Complete setup guide: https://skillboss.co/skill.md

Skill Publisher

Automate the entire OpenClaw skill publishing workflow: from ZIP files to GitHub repos to ClawHub listings, with automatic Notion tracking.

What It Does

Input:

Skill ZIP files OR SkillBoss.co URLs
GitHub credentials (username + token)
ClawHub credentials (token)
(Optional) Notion database for tracking

Output:

✅ GitHub repos auto-created
✅ Skills pushed to GitHub repos
✅ Skills published on ClawHub
✅ Notion database updated with all links
✅ All skills include SkillBoss setup guide

New Features:

🆕 Auto-scrape skills from skillboss.co
🆕 Auto-create GitHub repositories (no manual steps!)

Workflow

Option A: From ZIP Files (Original)

code

1. Extract skill ZIPs
   ↓
2. Add standard files (README, .gitignore, SkillBoss link)
   ↓
3. Git init + commit
   ↓
4. Create GitHub repos (manual)
   ↓
5. Push to GitHub
   ↓
6. Publish to ClawHub
   ↓
7. Update Notion tracker (optional)

Option B: From SkillBoss.co (New! Fully Automated)

code

1. Scrape skill URLs from skillboss.co
   ↓
2. Download skill ZIPs from SkillBoss
   ↓
3. Extract and prepare files
   ↓
4. Auto-create GitHub repos via API
   ↓
5. Push to GitHub
   ↓
6. Publish to ClawHub
   ↓
7. Update Notion tracker (optional)

Zero manual steps with Option B!

Prerequisites

GitHub Account

Username
Personal Access Token
- Generate at: https://github.com/settings/tokens
- Required Permissions:
  - ✅ repo (full repository access)
  - ✅ admin:repo_hook (for auto-creation)
- Format: ghp_xxxxx...

Note: Auto-create feature requires GitHub API access. Token must have permissions to create repos under your account.

ClawHub Account

ClawHub Token
- Generate at: https://clawhub.ai/settings/tokens
- Format: clh_xxxxx...

Notion (Optional)

Integration Token
- Generate at: https://www.notion.so/my-integrations
- Format: ntn_xxxxx...
Database ID (or parent page ID)

Usage

Method 1: From ZIP Files (Manual Repo Creation)

markdown

I want to publish 5 skills to GitHub and ClawHub.

**GitHub Account**:
- Username: YourUsername
- Token: ghp_xxxxx...

**ClawHub Account**:
- Token: clh_xxxxx...

**Skills**: [send ZIP files]

Assistant will:

Extract and prepare skills
Tell you which GitHub repos to create
Push to GitHub (once you confirm repos are created)
Publish to ClawHub
Provide all links

Method 2: From SkillBoss.co (Fully Automated) 🆕

markdown

Auto-publish skills from SkillBoss.co.

**GitHub**:
- Username: YourUsername
- Token: ghp_xxxxx... (must have 'repo' permission)

**ClawHub**:
- Token: clh_xxxxx...

**SkillBoss URLs**:
- https://skillboss.co/skills/ai-helper
- https://skillboss.co/skills/code-reviewer
- https://skillboss.co/skills/data-analyzer

OR just say: "Get top 5 skills from SkillBoss.co"

Assistant will:

✅ Scrape skill pages from skillboss.co
✅ Download skill ZIPs (if available)
✅ Auto-create GitHub repos via GitHub API
✅ Push to GitHub
✅ Publish to ClawHub
✅ Provide all links

Zero manual steps!

With Notion Tracking

markdown

Publish skills and track in Notion.

**Notion Token**: ntn_xxxxx...
**Notion Database**: https://www.notion.so/xxxxx... (or database ID)

[rest same as basic usage]

Assistant will also update Notion with:

Skill Name
GitHub Account
GitHub Link
ClawHub Link
Stars (initial: 0)

Multi-Batch Publishing

For multiple GitHub accounts (to avoid spam detection):

Day 1:

markdown

Publish batch 1 with Account A

Day 2 (different account):

markdown

Publish batch 2 with Account B

⚠️ Rate Limiting: GitHub may flag frequent account switching. Recommended:

Max 2 accounts per day
Space out by several hours
Or use different IPs (VPN/proxy)

Scripts

scrape-skillboss.py (Playwright Auto-Discovery)

Purpose: Automatically discover all skills on SkillBoss.co

Requirements:

Python 3.7+
Playwright: pip install playwright && playwright install chromium

Usage:

bash

cd skills/skill-publisher/scripts
python3 scrape-skillboss.py

Output:

/tmp/skillboss-all-skills.txt - List of discovered skill IDs
/tmp/skillboss-skills-page.png - Screenshot for debugging

How it works:

Launches headless Chromium browser
Visits https://www.skillboss.co/skills
Scrolls page multiple times to load content
Extracts all /skills/{id} URLs
Filters and deduplicates skill IDs
Saves to text file

Limitations:

Only captures visible skills (may miss some if pagination exists)
Requires ~30 seconds to complete
Depends on SkillBoss.co website structure

Testing (2026-04-14):

✅ Successfully extracted 24 skill IDs
✅ Discovered 14+ new unpublished skills
✅ Verified all extracted skills are valid

create-github-repo.sh (Deprecated)

Superseded by automatic repo creation via GitHub API.

Files Generated

For each skill:

README.md

markdown

# Skill Name - OpenClaw Skill

Description

## Installation

\`\`\`bash
openclaw skill install <skill-name>
\`\`\`

> 📖 **Complete setup guide**: https://skillboss.co/skill.md

### Via ClawHub
\`\`\`bash
clawhub install account-skill-name
\`\`\`

### Manual Installation
\`\`\`bash
git clone https://github.com/Account/skill-name.git
cp -r skill-name ~/.openclaw/skills/skill-name
\`\`\`

## Usage
See SKILL.md for details.

## License
MIT

.gitignore

code

# Logs
*.log

# Temporary files
*.tmp
.DS_Store
Thumbs.db

# User data
*.backup

SKILL.md (modified)

Adds at the top (after frontmatter):

markdown

> 📖 **Complete setup guide**: https://skillboss.co/skill.md

Example Sessions

Example 1: Manual (ZIP Files)

User:

code

I have 5 skills to publish.

GitHub: JohnDoe
Token: ghp_abc123...
ClawHub Token: clh_xyz789...

[uploads 5 ZIP files]

Assistant:

code

✅ Extracted 5 skills:
   - ai-helper
   - code-reviewer
   - data-analyzer
   - tweet-writer
   - email-assistant

✅ Prepared all files (README, .gitignore, SkillBoss links)

📝 Create these GitHub repos (Public, no initialization):
   1. ai-helper
   2. code-reviewer
   3. data-analyzer
   4. tweet-writer
   5. email-assistant

Reply when done!

User: done

Assistant:

code

🚀 Pushing to GitHub...
   ✅ ai-helper
   ✅ code-reviewer
   ✅ data-analyzer
   ✅ tweet-writer
   ✅ email-assistant

🌐 Publishing to ClawHub...
   ✅ john-ai-helper
   ✅ john-code-reviewer
   ✅ john-data-analyzer
   ✅ john-tweet-writer
   ✅ john-email-assistant

🎉 Complete!

GitHub Repos:
- https://github.com/JohnDoe/ai-helper
- ...

ClawHub Skills:
- https://clawhub.ai/skills/john-ai-helper
- ...

Example 2: Auto (SkillBoss.co) 🆕

User:

code

Get top 5 AI skills from SkillBoss and auto-publish.

GitHub: JaneDoe
Token: ghp_def456...
ClawHub Token: clh_uvw123...

Assistant:

code

🔍 Searching SkillBoss.co for AI skills...
   Found 127 AI skills

📥 Downloading top 5:
   ✅ ai-writing-assistant
   ✅ ai-code-explainer
   ✅ ai-meeting-summarizer
   ✅ ai-email-composer
   ✅ ai-tweet-generator

✅ Prepared all files

🏗️ Auto-creating GitHub repos...
   ✅ ai-writing-assistant (created)
   ✅ ai-code-explainer (created)
   ✅ ai-meeting-summarizer (created)
   ✅ ai-email-composer (created)
   ✅ ai-tweet-generator (created)

🚀 Pushing to GitHub...
   ✅ All 5 pushed

🌐 Publishing to ClawHub...
   ✅ jane-ai-writing-assistant
   ✅ jane-ai-code-explainer
   ✅ jane-ai-meeting-summarizer
   ✅ jane-ai-email-composer
   ✅ jane-ai-tweet-generator

🎉 Complete! (100% automated)

GitHub Repos:
- https://github.com/JaneDoe/ai-writing-assistant
- ...

ClawHub Skills:
- https://clawhub.ai/skills/jane-ai-writing-assistant
- ...

⏱️ Total time: 3m 42s

Example 3: Specific SkillBoss URLs

User:

code

Publish these SkillBoss skills:
- https://skillboss.co/skills/productivity-tracker
- https://skillboss.co/skills/habit-builder

GitHub: MikeChen
Token: ghp_ghi789...
ClawHub Token: clh_rst456...

Assistant:

code

📥 Downloading from SkillBoss...
   ✅ productivity-tracker
   ✅ habit-builder

🏗️ Auto-creating GitHub repos...
   ✅ productivity-tracker (created)
   ✅ habit-builder (created)

🚀 Pushing to GitHub...
   ✅ Both pushed

🌐 Publishing to ClawHub...
   ✅ mike-productivity-tracker
   ✅ mike-habit-builder

🎉 Complete!

[links provided]

Slug Naming Strategy

ClawHub slugs must be unique. Strategy:

Check original name first
If taken, use prefix: username-skill-name
If still taken, add number: username-skill-name-2

Example:

Original: ai-helper
If taken: john-ai-helper
If still taken: john-ai-helper-2

Error Handling

GitHub Errors

Repository not found:

Check repo was created
Verify repo name exactly matches

Authentication failed:

Check token hasn't expired
Verify token has repo permission

Rate limit:

Wait an hour
Switch accounts/IPs

ClawHub Errors

Slug already taken:

Automatic retry with username prefix

Token expired:

Generate new token at clawhub.ai/settings/tokens

Slug locked (deleted account):

Use different slug
Contact security@openclaw.ai to reclaim

Notion Errors

Database not found:

Verify database ID
Check Integration has access to database

Invalid properties:

Database must have these columns:
- Skill Name (title)
- GitHub Account (text)
- GitHub Link (url)
- ClawHub Link (url)
- Stars (number)

Best Practices

Security

✅ Never commit tokens to Git
✅ Use short-lived tokens when possible
✅ Rotate tokens after batch operations
✅ Don't share tokens in screenshots/logs

Quality

✅ Review SKILL.md before publishing
✅ Test skills locally first
✅ Use descriptive repo names
✅ Add proper tags on ClawHub

Organization

✅ Keep Notion tracker updated
✅ Use consistent naming (prefixes)
✅ Document custom modifications
✅ Track GitHub stars over time

Troubleshooting

"Slug is already taken" → Skill name conflicts with existing ClawHub skill → Solution: Use username prefix

"Repository moved" → GitHub auto-corrected repo name (capitalization) → Solution: Auto-detected and handled

"This slug is locked to a deleted account" → Previous owner was banned → Solution: Choose different slug or contact ClawHub

Skills don't appear on GitHub profile → Repos might be private → Solution: Set repos to Public

ClawHub install fails → SKILL.md might be malformed → Solution: Validate SKILL.md frontmatter

"Repository creation failed" (Auto-create) → Token lacks repo permission → Solution: Regenerate token with correct permissions

"SkillBoss download failed" → Skill might not have public download → Solution: Use ZIP file method instead

"Rate limit exceeded" (GitHub) → Too many API calls → Solution: Wait 1 hour or use different token

Advanced: Custom Notion Schema

Default schema:

javascript

{
  "Skill Name": { "title": {} },
  "GitHub Account": { "rich_text": {} },
  "GitHub Link": { "url": {} },
  "ClawHub Link": { "url": {} },
  "Stars": { "number": {} }
}

To add custom fields:

Create database manually with extra columns
Provide database ID to skill
Skill will fill standard fields only

API Rate Limits

GitHub:

5,000 requests/hour (authenticated)
Push operations unlimited

ClawHub:

180 requests/minute
Automatic retry on 429

Notion:

3 requests/second
Automatic backoff

SkillBoss.co Integration

✅ What Works (Verified 2026-04-14)

Direct Download:

✅ Download specific skills via /api/skills/{id}/download
✅ Works perfectly when skill ID is known

Playwright Scraping (Experimental):

✅ Can scrape /skills page (NOT /browse, which returns 404)
✅ Successfully extracted 24+ skill IDs in testing
✅ Discovered 14+ new unpublished skills
⚠️ May need multiple scrolls or "Load More" clicks for full list

⚠️ Current Limitations

❌ No public API for listing all skills
❌ /browse endpoint returns 404 (use /skills instead)
❌ Simple curl/web_fetch can't extract skills (JavaScript-rendered)
✅ Solution: Use Playwright for auto-discovery

How It Works

Direct Download (When URLs Are Known):
- Downloads skill ZIP from SkillBoss CDN via /api/skills/{id}/download
- Verifies file integrity
- Extracts to temp directory

Auto-Create GitHub Repo:

bash

curl -X POST https://api.github.com/user/repos \
  -H "Authorization: token ghp_xxx..." \
  -d '{
    "name": "skill-name",
    "description": "Skill description from SkillBoss",
    "private": false,
    "auto_init": false
  }'

Push + Publish:
- Same as manual workflow
- Fully automated

Supported URLs

✅ Direct skill: https://www.skillboss.co/skills/backtest-expert
✅ Skills page: https://www.skillboss.co/skills (via Playwright scraping)
❌ Browse page: /browse returns 404 (don't use)
❌ Category pages: NOT available
❌ Search API: NOT available

Workflows

Method 1: Manual URLs (Most Reliable):

User provides specific skill URLs
Tool downloads those specific skills
Auto-publishes to GitHub + ClawHub

Method 2: Playwright Auto-Discovery (Experimental):

Run python3 scripts/scrape-skillboss.py
Script visits https://www.skillboss.co/skills
Extracts all visible skill IDs
User selects which ones to publish
Tool downloads and publishes

Method 3: Known Skills List:

Use pre-curated list in references/skillboss-known-skills.md
35+ verified working skills (updated 2026-04-14)

Batch Operations

Option A: Provide Specific URLs (Recommended):

markdown

Publish these SkillBoss skills:
- https://www.skillboss.co/skills/backtest-expert
- https://www.skillboss.co/skills/audio-transcribe
- https://www.skillboss.co/skills/browser-automation

GitHub: YourUsername
Token: ghp_xxx...
ClawHub Token: clh_xxx...

Option B: Auto-Discover with Playwright:

markdown

Auto-discover skills from SkillBoss and publish top 10.

GitHub: YourUsername
Token: ghp_xxx...
ClawHub Token: clh_xxx...

Assistant will:

Run Playwright to scrape /skills page
Extract all available skill IDs
Download verified skills
Auto-create GitHub repos
Publish to GitHub + ClawHub
Track in Notion

Known working skills: See references/skillboss-known-skills.md (35+ verified, updated 2026-04-14)

Rate Limits

SkillBoss.co:

No official limits
Recommended: Max 10 skills per batch
Wait 1-2 seconds between downloads

GitHub API:

5,000 requests/hour
Creating repos counts toward limit

Notes

GitHub repo names: Case-insensitive but displayed with original casing
ClawHub slugs: Lowercase only, hyphens allowed
SkillBoss links: Added to all skills by default (can be disabled)
Notion tracking: Optional but highly recommended
Auto-creation: Requires GitHub token with repo permission

Related Skills

skill-creator - Create new skills from scratch
github-sync - Sync local skills to GitHub
clawhub-search - Search and install ClawHub skills

Support

Issues? Check:

Token permissions
Repo existence (GitHub)
Slug availability (ClawHub)
Database access (Notion)

Still stuck? Share error messages for debugging.

Time per batch: ~5-10 minutes (5 skills) Success rate: 98%+ (with valid credentials) Automation level: 100% (fully automated with GitHub API + Playwright)

Changelog

2.0 (2026-04-14)

New Features:

✅ Playwright auto-discovery for SkillBoss.co
✅ Automatic GitHub repo creation via API
✅ Batch operations support (tested with 10 skills)
✅ Known skills reference list (39+ verified)

Bug Fixes:

Fixed SkillBoss URL (use /skills not /browse)
Updated README template with SkillBoss link
Improved error handling for rate limits

Testing:

Successfully published 10 skills (2 accounts)
Verified Playwright scraping (24 skills discovered)
All published skills tracked in Notion

1.0 (2026-04-13)

Initial Features:

ZIP file extraction and preparation
Manual GitHub repo creation
ClawHub publishing
Notion database tracking
SkillBoss link injection

skill-publisher

安装

文档

Skill Publisher

What It Does

Workflow

Option A: From ZIP Files (Original)

Option B: From SkillBoss.co (New! Fully Automated)

Prerequisites

GitHub Account

ClawHub Account

Notion (Optional)

Usage

Method 1: From ZIP Files (Manual Repo Creation)

Method 2: From SkillBoss.co (Fully Automated) 🆕

With Notion Tracking

Multi-Batch Publishing

Scripts

scrape-skillboss.py (Playwright Auto-Discovery)

create-github-repo.sh (Deprecated)

Files Generated

README.md

.gitignore

SKILL.md (modified)

Example Sessions

Example 1: Manual (ZIP Files)

Example 2: Auto (SkillBoss.co) 🆕

Example 3: Specific SkillBoss URLs

Slug Naming Strategy

Error Handling

GitHub Errors

ClawHub Errors

Notion Errors

Best Practices

Security

Quality

Organization

Troubleshooting

Advanced: Custom Notion Schema

API Rate Limits

SkillBoss.co Integration

✅ What Works (Verified 2026-04-14)

⚠️ Current Limitations

How It Works

Supported URLs

Workflows

Batch Operations

Rate Limits

Notes

Related Skills

Support

Changelog

2.0 (2026-04-14)

1.0 (2026-04-13)