Add sync-skills script for syncing skills to target projects

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: justin808

README.md

@@ -104,6 +104,7 @@ Starter templates for new projects:
 | Script | Description |
 |--------|-------------|
 | [`bin/sync-commands`](bin/sync-commands) | Sync commands from this repo into a target project's `.claude/commands/` |
+| [`bin/sync-skills`](bin/sync-skills) | Sync skills from this repo into a target project's `.claude/skills/` |
 | [`bin/chrome-mcp`](bin/chrome-mcp) | Launch Chrome with a separate profile for MCP browser debugging |
 | `bin/set-review-instructions` | Initialize file-by-file review with instructions and changed file list |
 | `bin/print-git-diff` | Print diff, before/after, and review instructions for a single file |
@@ -120,9 +121,9 @@ Starter templates for new projects:
 | [Claude Code Review](.github/workflows/claude-code-review.yml) | Automatic PR review on open/sync |
 | [Claude Code](.github/workflows/claude.yml) | Respond to `@claude` mentions in issues/PRs |
 
-## Syncing Commands to Your Project
+## Syncing to Your Project
 
-This repo is the canonical source for shared commands like `/address-review`. To keep a project in sync:
+This repo is the canonical source for shared commands and skills. Use the sync scripts to keep a project up to date.
 
 ### One-Time Setup
 
@@ -144,27 +145,33 @@ cp "$BOOSTERS/commands/address-review.md" .claude/commands/
 
 ### Keeping Up to Date
 
-Run `bin/sync-commands` from this repo to pull the latest commands into a target project:
+Run the sync scripts from this repo to pull the latest commands or skills into a target project:
 
 ```bash
 # Sync all commands to a project
 ./bin/sync-commands ~/projects/my-app
 
 # Sync a specific command
 ./bin/sync-commands ~/projects/my-app address-review
+
+# Sync all skills to a project
+./bin/sync-skills ~/projects/my-app
+
+# Sync a specific skill
+./bin/sync-skills ~/projects/my-app docs
 ```
 
 ### For AI Agents in Consuming Repos
 
 Add this to your project's `CLAUDE.md` or `AGENTS.md` so agents know where shared commands come from:
 
 ```markdown
-## Shared Commands
+## Shared Commands and Skills
 
-The `/address-review` command is synced from
+Commands and skills are synced from
 [claude-code-commands-skills-agents](https://github.com/shakacode/claude-code-commands-skills-agents).
-Do not edit `.claude/commands/address-review.md` directly — update the
-canonical copy in the boosters repo and re-sync.
+Do not edit `.claude/commands/` or `.claude/skills/` directly — update the
+canonical copies in the boosters repo and re-sync.
 ```
 
 See the [templates/](templates/) directory for starter `CLAUDE.md` and `AGENTS.md` files that include this pattern.

bin/sync-skills

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+#
+# Sync skills from this repo into a target project's .claude/skills/ directory.
+#
+# Usage:
+#   ./bin/sync-skills <target-project-path> [skill-name]
+#
+# Examples:
+#   ./bin/sync-skills ~/projects/my-app          # Sync all skills
+#   ./bin/sync-skills ~/projects/my-app docs      # Sync one skill
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+SKILLS_DIR="$REPO_ROOT/skills"
+
+if [ $# -lt 1 ]; then
+  echo "Usage: $(basename "$0") <target-project-path> [skill-name]"
+  echo ""
+  echo "Syncs skills from claude-code-commands-skills-agents into a project."
+  echo ""
+  echo "Examples:"
+  echo "  $(basename "$0") ~/projects/my-app"
+  echo "  $(basename "$0") ~/projects/my-app docs"
+  exit 1
+fi
+
+TARGET="$1"
+SKILL="${2:-}"
+
+if [ ! -d "$TARGET" ]; then
+  echo "Error: target directory does not exist: $TARGET"
+  exit 1
+fi
+
+TARGET_DIR="$TARGET/.claude/skills"
+mkdir -p "$TARGET_DIR"
+
+if [ -n "$SKILL" ]; then
+  SOURCE="$SKILLS_DIR/$SKILL"
+  if [ ! -d "$SOURCE" ]; then
+    echo "Error: skill not found: $SOURCE"
+    echo "Available skills:"
+    for d in "$SKILLS_DIR"/*/; do
+      [ -d "$d" ] && echo "  $(basename "$d")"
+    done
+    exit 1
+  fi
+  cp -r "$SOURCE" "$TARGET_DIR/"
+  echo "Synced $SKILL -> $TARGET_DIR/$SKILL/"
+else
+  for d in "$SKILLS_DIR"/*/; do
+    [ -d "$d" ] || continue
+    SKILL_NAME="$(basename "$d")"
+    cp -r "$d" "$TARGET_DIR/"
+    echo "Synced $SKILL_NAME -> $TARGET_DIR/$SKILL_NAME/"
+  done
+fi
+
+echo ""
+echo "Done. Skills are now in $TARGET_DIR/"
+echo ""
+echo "To use skills, add the skills directory via --add-dir or settings.json:"
+echo "  claude --add-dir $TARGET_DIR"
+echo "  Or add to .claude/settings.json: {\"additionalDirectories\": [\"$TARGET_DIR\"]}"