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