Claude Code Guide 🌿
A Claude Code Guide — interactive onboarding and Q&A on setup, best practices, automation, and effective workflows, packaged as a plugin. Designed with love for beginners 🌱 to experts. 🌳
Platforms: Tested on Windows (Git Bash), macOS, and Linux (Ubuntu).
New! Enable a proactive learning with Game Mode!
Enable with /guide:game-mode on
Listen to this guide — NotebookLM audio overview provides an AI-generated audio reflection of the guide content.
⭐ Find this useful? Star the repo to follow updates and show support!
Install as a Claude Code Plugin
This repo is a Claude Code plugin. Install it to get interactive guide skills directly inside Claude Code.
Requires Claude Code v1.0.33 or later. Run
claude --versionto check. See setup docs to install or update.
Install from GitHub (recommended)
From within Claude Code:
/plugin marketplace add OriNachum/claude-code-guide
/plugin install guide@claude-code-guide
Or from the CLI:
claude plugin marketplace add OriNachum/claude-code-guide
claude plugin install guide@claude-code-guide
The plugin name is
guideand the marketplace name isclaude-code-guide(frommarketplace.json), so the install target isguide@claude-code-guide.
After installing, restart Claude Code or run
/reload-pluginsfor the plugin skills to become available.
Updating
/plugin update guide@claude-code-guide
Other installation methods
Try without installing (session only)
git clone https://github.com/OriNachum/claude-code-guide.git
claude --plugin-dir ./claude-code-guide
Loads the plugin for the current session only. No restart needed.
Install from a local clone
/plugin marketplace add ./claude-code-guide
/plugin install guide@claude-code-guide
Or from the CLI:
claude plugin marketplace add ./claude-code-guide
claude plugin install guide@claude-code-guide
Usage
Once installed, five skills are available:
/guide:onboard— Interactive getting-started walkthrough. Guides you through environment setup, your first session, and best practices./guide:ask— Ask any question about Claude Code features. Reads relevant reference docs to give accurate, detailed answers./guide:game-mode— Enable Game Mode. The guide locally tracks your usage of Claude, assigns a level per feature area, and helps you master Claude Code./guide:level-up— Feature roadmap and personalized next-step coaching. Shows what to learn next based on your current skill level./guide:migrate-to-claude— Migrate your Cursor, Windsurf, Copilot, Continue, Aider, Cody, or Codex configs to Claude Code. Discovers configs, trims bloat, and proposes a clean migration plan./guide:visualize-setup— Interactive dashboard of all installed skills, MCP servers, and setup configuration.
Hooks in action
This plugin doubles as a real-world hooks example. Game Mode uses all three hook events to power its gamification system:
- PostToolUse — tracks which Claude Code features you use (track-usage.sh)
- UserPromptSubmit — detects slash-command usage (skills, plugins,
/loop) in your prompts (track-prompt.sh) - Stop — counts sessions, tracks tokens, and nudges you to try new features at Fibonacci intervals (track-stop.sh)
See hooks.json and hooks/scripts/ for the full implementation.
Documentation
User Stories
Learn by example — these narrative walkthroughs show Claude Code in realistic, end-to-end scenarios where multiple features come together. Each story follows a developer through a real workflow, so you can see how the pieces fit.