Claude Code Global Configuration

Portable skills, agents, and context files for Claude Code. Works across all projects on any machine.

Setup on a New Machine

# Clone this repo as your ~/.claude directory
git clone https://github.com/<your-username>/claude-dotfiles.git ~/.claude

# Run setup to install gstack (requires internet + Bun)
chmod +x ~/.claude/setup.sh && ~/.claude/setup.sh

What's Included

Skills (45)

gstack (28) — installed via setup.sh, not tracked in git: /autoplan, /benchmark, /browse, /canary, /careful, /codex, /cso, /design-consultation, /design-review, /document-release, /freeze, /gstack-upgrade, /guard, /investigate, /land-and-deploy, /office-hours, /plan-ceo-review, /plan-design-review, /plan-eng-review, /qa, /qa-only, /retro, /review, /setup-browser-cookies, /setup-deploy, /ship, /supabase, /unfreeze

mrjonesbot (9): /accessibility-audit, /fix-ci, /fly-mpg-migrate, /geo-seo-audit, /keyword-research, /memory-audit, /rubycritic, /ship-rails, /translate-views

Anthropic (7): /algorithmic-art, /canvas-design, /doc-coauthoring, /internal-comms, /mcp-builder, /skill-creator, /web-artifacts-builder

Custom (1): /rails-setup — Bootstrap Rails projects with claude-on-rails gem

Agents (3)

• @ci-fixer — Autonomous CI failure resolution
• @design-review — Comprehensive UI/UX review with Playwright
• @performance-auditor — Rails memory/performance audit

Context Files

• context/design-principles.md — UI/UX design system
• context/workflow.md — Browser tooling protocols
• context/patterns/ — 7 Rails/Hotwire UI patterns

Updating

# Pull latest config
cd ~/.claude && git pull

# Update gstack
~/.claude/setup.sh

What's NOT Tracked

Credentials, conversation history, session data, caches, per-project settings, and telemetry are all gitignored. See .gitignore for the full list.