# Skill Sync

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

- Skill: `tools-only/skill-sync` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add tools-only/skill-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/skill-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/tools-only/skill-sync

---


# 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

```bash
# 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

```bash
# 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
```