skill-sync

name	skill-sync
description	Sync Clawdbot skills between local installation and the shared skill repository. Use when asked to install, update, list, or push skills.

Skill Sync

Manage skills from the shared PSPDFKit clawdbot-skills repository.

🔐 Never commit secrets! Skills are shared code. Keep API keys, tokens, and credentials in local config files, not in SKILL.md or scripts.

Quick Reference

# List available skills in the repo
skill-sync list

# Install a single skill
skill-sync install <skill-name>

# Install/update all skills from repo
skill-sync install --all

# Push a local skill to the repo
skill-sync push <skill-name>

# Update the local repo cache
skill-sync update

Commands

skill-sync list

Shows all skills available in the remote repository.

skill-sync install <name>

Installs or updates a skill from the repo to your local skills directory.

• Pulls latest from repo
• Copies skill folder to local skills dir
• Overwrites if already exists

skill-sync install --all

Installs or updates ALL skills from the repo.

skill-sync push <name>

Pushes a local skill to the shared repository via Pull Request.

• Creates a feature branch (skill/<name>)
• Copies skill from local skills dir to repo
• Commits and pushes the branch
• Opens a PR for review using gh CLI

⚠️ Security Warning: Before pushing, ensure your skill does NOT contain:

• API keys, tokens, or secrets
• Passwords or credentials
• Personal access tokens
• Client secrets or refresh tokens

Keep credentials in local config files (e.g., ~/.config/) and reference them via environment variables or paths in your skill documentation.

skill-sync update

Just pulls the latest from the repo without installing anything. Useful to see what's new.

Configuration

The script uses these paths:

• Repo clone: ~/.clawdbot-skills-repo
• Local skills: ~/clawd/skills (or $CLAWD_SKILLS_DIR if set)
• Remote: https://github.com/PSPDFKit/clawdbot-skills.git

First-Time Setup

The script auto-clones on first run. No manual setup needed.

Examples

# See what skills are available
skill-sync list

# Install the buildkite-mcp skill
skill-sync install buildkite-mcp

# You made a cool new skill locally, share it
skill-sync push my-cool-skill

# Get latest updates for all skills
skill-sync install --all