Claude Workshop Skills

Curated Claude MCP skills ready for live workshops and self-serve setup. The repository mirrors the structure of ~/.claude so attendees can copy everything, cherry-pick a single skill, or script their own install flow with the GitHub CLI.

Repository Layout

.
├── skills/                 # Skill definitions plus reference docs
├── hooks/                  # Bun-powered approval hooks for certain skills
├── settings/               # Claude hook wiring (JSON) and supporting packages
├── mcp/                    # MCP server definitions (Chrome DevTools)
└── scripts/                # Helper utilities for selective installs

Skill Index

Prerequisites

• GitHub CLI (gh) authenticated for the attendee.
• bun installed and on PATH for skills that invoke Bun hooks (currently Chrome DevTools and GitHub).
• rsync (or adjust commands to use cp -R) for copying into ~/.claude.

Quick Start (Full Mirror)

# Replace with the public repo slug you publish
REPO_SLUG="johnlindquist/claude-workshop-skills"
WORKDIR="$HOME/Downloads/claude-workshop-skills"

# 1. Backup existing Claude config
tar -czf "$HOME/.claude-backup.$(date +%Y%m%d).tgz" -C "$HOME" .claude

# 2. Clone the skills repo
gh repo clone "$REPO_SLUG" "$WORKDIR"

# 3. Copy into ~/.claude (dry run first if desired)
rsync -av --exclude='.git' "$WORKDIR/" "$HOME/.claude/"

# 4. Install hook dependencies
(cd "$HOME/.claude/hooks" && bun install)
(cd "$HOME/.claude/settings" && bun install)

Restart Claude (or reload the workspace) so it picks up new skills, hooks, and MCP servers.

Selective Installation with the Helper Script

After cloning the repository, run the included script to copy everything needed for a single skill:

REPO_DIR="$HOME/Downloads/claude-workshop-skills"
cd "$REPO_DIR"

# Examples
./scripts/install-skill.sh github
./scripts/install-skill.sh chrome-devtools

The script copies the skill folder plus any required hooks, settings, or MCP files into ~/.claude and reminds attendees to update settings.json if needed.

Override the destination with CLAUDE_HOME:

CLAUDE_HOME="$HOME/.claude-workshop" ./scripts/install-skill.sh diagram

gh CLI Sparse Checkout (Single Skill Download)

Attendees who only want one skill can fetch just the relevant directories using sparse checkout:

REPO_SLUG="johnlindquist/claude-workshop-skills"
WORKDIR="$(mktemp -d)"

gh repo clone "$REPO_SLUG" "$WORKDIR" -- --filter=blob:none --sparse
cd "$WORKDIR"

# Pull only what the helper script needs
git sparse-checkout set \
  scripts/install-skill.sh \
  skills/github \
  hooks/hooks.github.ts \
  settings/settings.github.json

# Install the skill
./scripts/install-skill.sh github

Swap skills/github and the supporting files for whichever skill they want (see the Skill Index table for dependencies). This keeps bandwidth low while still using the helper script to wire everything correctly.

Manual Selective Copy (No Script)

REPO_SLUG="johnlindquist/claude-workshop-skills"
WORKDIR="$(mktemp -d)"
gh repo clone "$REPO_SLUG" "$WORKDIR"

# Copy only the diagram skill
rsync -av "$WORKDIR/skills/diagram/" "$HOME/.claude/skills/diagram/"

# If the skill has hooks/settings, copy those too
rsync -av "$WORKDIR/hooks/hooks.github.ts" "$HOME/.claude/hooks/"
rsync -av "$WORKDIR/settings/settings.github.json" "$HOME/.claude/settings/"

Edit ~/.claude/settings.json so the relevant Skill(...) entries are allowed, then restart Claude.

Updating After the Workshop

REPO_SLUG="johnlindquist/claude-workshop-skills"
WORKDIR="$HOME/Downloads/claude-workshop-skills"

cd "$WORKDIR"
gh repo sync "$REPO_SLUG"
rsync -av --exclude='.git' "$WORKDIR/" "$HOME/.claude/"

Sparse-checkout clones can run git pull followed by the same ./scripts/install-skill.sh <skill> command to refresh local copies.

Troubleshooting

• Hooks fail with bun: command not found

...