{
  "markdown": "> **Looking for the official Claude Code guide?** See [Anthropic's Claude Code documentation](https://docs.anthropic.com/en/docs/claude-code/overview).\n> This is a community plugin to help you proactively master Claude Code.\n\n# Claude Code Guide 🌿\n\n<img width=\"1236\" height=\"380\" alt=\"image\" src=\"https://github.com/user-attachments/assets/1b8117a7-47cf-406b-a2f3-91243879945f\" />\n\n\nA Claude Code Guide — interactive onboarding and Q&A on setup, best practices, automation, and effective workflows, packaged as a plugin.\nDesigned with love for beginners 🌱 to experts. 🌳\n\n**Platforms:** Tested on **Windows** (Git Bash), **macOS**, and **Linux** (Ubuntu).\n\n**New!** Enable a proactive learning with **Game Mode**!  \nEnable with `/guide:game-mode on`\n\n> **Listen to this guide** — [NotebookLM audio overview](https://notebooklm.google.com/notebook/61c00692-3e07-4cac-887a-3360520d8f94) provides an AI-generated audio reflection of the guide content.\n>\n> **Featured on** — [AI Tool Review](https://aitoolreview.ai/guides/) lists this guide among its curated Claude Code resources.\n\n*⭐ Find this useful? Star the repo to follow updates and show support!* <a href=\"https://github.com/OriNachum/claude-code-guide/stargazers\"><img src=\"https://img.shields.io/github/stars/OriNachum/claude-code-guide?style=social\" alt=\"GitHub stars\"></a>\n\n<p align=\"center\">\n  <img width=\"384\" height=\"256\" alt=\"image\" src=\"https://github.com/user-attachments/assets/5330f813-6539-4e15-bb94-0e1994edd94c\" />\n</p>\n\n## Install as a Claude Code Plugin\n\nThis repo is a **Claude Code plugin**. Install it to get interactive guide skills directly inside Claude Code.\n\n> **Requires Claude Code v1.0.33 or later.** Run `claude --version` to check. See [setup docs](https://code.claude.com/docs/en/quickstart#step-1-install-claude-code) to install or update.\n\n### Install from GitHub (recommended)\n\nFrom within Claude Code:\n\n```shell\n/plugin marketplace add OriNachum/claude-code-guide\n/plugin install guide@claude-code-guide\n```\n\nOr from the CLI:\n\n```bash\nclaude plugin marketplace add OriNachum/claude-code-guide\nclaude plugin install guide@claude-code-guide\n```\n\n> The plugin name is `guide` and the marketplace name is `claude-code-guide` (from `marketplace.json`), so the install target is `guide@claude-code-guide`.\n\n> After installing, restart Claude Code or run `/reload-plugins` for the plugin skills to become available.\n\n### Updating\n\n```shell\n/plugin update guide@claude-code-guide\n```\n\n### Other installation methods\n\n<details>\n<summary>Try without installing (session only)</summary>\n\n```bash\ngit clone https://github.com/OriNachum/claude-code-guide.git\nclaude --plugin-dir ./claude-code-guide\n```\n\nLoads the plugin for the current session only. No restart needed.\n\n</details>\n\n<details>\n<summary>Install from a local clone</summary>\n\n```shell\n/plugin marketplace add ./claude-code-guide\n/plugin install guide@claude-code-guide\n```\n\nOr from the CLI:\n\n```bash\nclaude plugin marketplace add ./claude-code-guide\nclaude plugin install guide@claude-code-guide\n```\n\n</details>\n\n### Usage\n\nOnce installed, seven skills are available:\n\n- **`/guide:onboard`** — Interactive getting-started walkthrough. Guides you through environment setup, your first session, and best practices.\n- **`/guide:ask`** — Ask any question about Claude Code features. Reads relevant reference docs to give accurate, detailed answers.\n- **`/guide:introspect`** — Introspective Development. Audit your project's lifecycle coverage, find gaps in tooling and docs, and auto-fix what it finds. Run after a task to ask \"How could I have done it better?\"\n- **`/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.\n- **`/guide:level-up`** — Feature roadmap and personalized next-step coaching. Shows what to learn next based on your current skill level.\n- **`/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.\n- **`/guide:visualize-setup`** — Interactive dashboard of all installed skills, MCP servers, and setup configuration.\n\n#### Level up\n\n<img width=\"1050\" alt=\"image\" src=\"https://github.com/user-attachments/assets/5e47db03-511d-469c-a258-e42022360988\" />\n\n\n#### VIsualize setup\n\n<img width=\"1231\" height=\"1300\" alt=\"image\" src=\"https://github.com/user-attachments/assets/527000c6-486f-49e8-aea9-afdec13a0cc6\" />\n\n<img width=\"1231\" height=\"707\" alt=\"image\" src=\"https://github.com/user-attachments/assets/c8d2b970-5baf-4d5f-9084-f0bbd94a6d21\" />\n\n\n### Hooks in action\n\nThis plugin doubles as a **real-world hooks example**. Game Mode uses all three hook events to power its gamification system:\n\n- **PostToolUse** — tracks which Claude Code features you use ([track-usage.sh](hooks/scripts/track-usage.sh))\n- **UserPromptSubmit** — detects slash-command usage (skills, plugins, `/loop`) in your prompts ([track-prompt.sh](hooks/scripts/track-prompt.sh))\n- **Stop** — counts sessions, tracks tokens, and nudges you to try new features at Fibonacci intervals ([track-stop.sh](hooks/scripts/track-stop.sh))\n\nSee [hooks.json](hooks/hooks.json) and [hooks/scripts/](hooks/scripts/) for the full implementation.\n\n## Documentation\n\n### User Stories\n\nLearn 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.\n\n- [Daily Workflow](skills/ask/references/daily-workflow.md) — A typical day using Claude Code, from morning context to end-of-day\n- [Getting Started with Claude Code](skills/ask/references/starting-new-repo.md) — Your first days on an existing team — /init, building skills organically\n- [New Project in Existing Repo](skills/ask/references/new-project-existing-repo.md) — Adding a new module/service within an existing codebase\n- [Auto-Maintain CLAUDE.md](skills/ask/references/auto-maintain-claude-md.md) — GitHub Actions cron job to keep CLAUDE.md fresh weekly\n- [Context Management](skills/ask/references/context-management-and-clear.md) — When to use /clear, /compact, and how to manage context\n- [Sub Agents in a Monolith](skills/ask/references/sub-agents-in-monolith.md) — Using sub agents to navigate and work within a large monolith\n- [Discovering Plugins](skills/ask/references/discovering-plugins.md) — Browsing marketplaces, evaluating, and installing your first plugins\n- [Memory in Practice](skills/ask/references/memory-in-practice.md) — How auto memory works — corrections that stick, promoting to CLAUDE.md\n- [Automated Briefings](skills/ask/references/automated-briefings.md) — Production monitoring with /loop — deploys, post-deploy validation, on-call triage\n- [Migrating from Other AI Tools](skills/ask/references/migrating-from-other-tools.md) — Moving from Cursor, Windsurf, Copilot, Codex — what maps where, what to trim\n\n### Getting Started\n\n- [Setting Your Environment](skills/ask/references/beginner/setting-your-environment.md) — CLAUDE.md, permissions, model selection, MCP servers, customization\n- [Starting to Work](skills/ask/references/beginner/starting-to-work.md) — Permission modes, Plan Mode, Accept Edits, the explore-plan-implement workflow\n- [Choosing Your Model](skills/ask/references/beginner/choosing-your-model.md) — Fable 5, Opus 4.8, Sonnet 4.6, Haiku, effort levels, when to use each\n- [Best Practices](skills/ask/references/intermediate/best-practices.md) — Self-testing loops, context management, effective prompting, common failure patterns\n- [Auto Memory](skills/ask/references/beginner/memory.md) — How Claude remembers across sessions, comparison with CLAUDE.md\n\n### Automation\n\n- [Automating Your Workflows](skills/ask/references/intermediate/automating-your-workflows.md) — Overview of the three automation mechanisms: Hooks, Skills, Sub Agents\n- [Hooks](skills/ask/references/intermediate/hooks.md) — Lifecycle event automation — triggers, handlers, matchers, common patterns\n- [Hooks HTTP](skills/ask/references/expert/hooks-http.md) — HTTP-based hook patterns and integrations\n- [Skills](skills/ask/references/intermediate/skills.md) — Creating reusable prompt workflows as Markdown skill files\n- [Sub Agents](skills/ask/references/expert/sub-agents.md) — Specialist agent delegation with scoped permissions, worktree isolation\n- [Agent Teams](skills/ask/references/expert/team-mode.md) — ⚠️ Experimental: coordinated multi-agent sessions with shared task lists\n\n### Configuration & Extensions\n\n- [Configuring Your Claude](skills/ask/references/intermediate/configuring-your-claude.md) — Ongoing configuration — when to build skills, agents, hooks, and how they evolve\n- [Plugins](skills/ask/references/intermediate/plugins.md) — Installing, creating, and sharing Claude Code plugins\n- [Marketplace](skills/ask/references/intermediate/marketplace.md) — Discovering, browsing, evaluating, publishing, and managing plugin marketplaces\n- [Plugin Examples](skills/ask/references/intermediate/plugin-examples.md) — Curated showcase of notable plugins with patterns and install instructions\n- [MCP](skills/ask/references/intermediate/mcp.md) — MCP (Model Context Protocol) — when to use it, the restaurant analogy, server setup and scopes\n- [Built-ins](skills/ask/references/beginner/built-ins.md) — Built-in slash commands, bundled skills, hook events, sub agents, and tools\n- [Ongoing Work](skills/ask/references/expert/ongoing-work.md) — Managing long-running tasks, resuming work, and session continuity\n\n### Integrations\n\n- [Claude Agent SDK](skills/ask/references/expert/agent-sdk.md) — TypeScript and Python SDKs for programmatic Claude Code integration\n- [GitHub Actions](skills/ask/references/intermediate/github-actions.md) — Running Claude Code in CI/CD pipelines with GitHub Actions\n\n### Platform Support\n\n- [Windows Support](docs/windows-support.md) — Setup, jq installation, and Windows-specific adjustments\n\n### Other\n\n- [Loop](skills/ask/references/intermediate/loop.md) — Running recurring tasks with /loop — polling, deploy monitoring, on-call triage\n\n## Repository structure\n\n```text\nclaude-code-guide/\n├── .claude-plugin/\n│   ├── plugin.json ........................ Plugin manifest (name: \"guide\", version, metadata)\n│   └── marketplace.json .................. Marketplace manifest\n├── .github/\n│   └── workflows/\n│       └── tests.yml ...................... Bash test suite (bats-core)\n├── _includes/\n│   ├── footer_custom.html ................. Disclaimer footer\n│   └── head_custom.html ................... .md twin <link rel=alternate> header\n├── _plugins/\n│   └── llm_markdown.rb .................... Build-time generator: .md twin per page + llms-full.txt\n├── _sass/\n│   └── color_schemes/\n│       └── anthropic.scss ................. Anthropic cream color scheme\n├── hooks/\n│   ├── hooks.json ......................... Hook event configuration (PostToolUse, UserPromptSubmit, Stop)\n│   └── scripts/\n│       ├── track-usage.sh ................. PostToolUse handler — tracks feature usage\n│       ├── track-prompt.sh ................ UserPromptSubmit handler — tracks slash-command usage\n│       ├── track-stop.sh .................. Stop handler — token tracking, session counting, and Fibonacci nudges\n│       └── migrate-data.sh ................ Lightweight schema migration on version upgrade\n├── skills/\n│   ├── onboard/\n│   │   └── SKILL.md ...................... Interactive getting-started walkthrough\n│   ├── ask/\n│   │   ├── SKILL.md ...................... Q&A against reference docs\n│   │   └── references/ ................... Reference docs organized by tier\n│   │           ├── beginner/ ............. 🌱 Beginner feature docs (5 files)\n│   │           ├── intermediate/ ......... 🌿 Intermediate feature docs (11 files)\n│   │           ├── expert/ ............... 🌳 Expert feature docs (5 files)\n│   │           └── *.md .................. Story walkthroughs (10 files)\n│   ├── game-mode/\n│   │   └── SKILL.md ...................... Gamified usage tracker with levels\n│   ├── level-up/\n│   │   └── SKILL.md ...................... Feature roadmap and coaching hints\n│   ├── migrate-to-claude/\n│   │   └── SKILL.md ...................... AI tool config migration assistant\n│   └── visualize-setup/\n│       └── SKILL.md ...................... Interactive HTML setup dashboard generator\n├── agents/\n│   ├── doc-verifier.md .................... On-demand reference doc accuracy verifier (Sonnet agent)\n│   ├── pr-review.md ....................... Pull request review sub-agent (Sonnet agent)\n│   └── version-bump.md .................... Synced version bumper for plugin.json + marketplace.json (Haiku agent)\n├── tests/\n│   ├── helpers/\n│   │   └── setup.sh ...................... Common test fixtures and mock data\n│   ├── track-usage.bats .................. Tests for PostToolUse hook\n│   ├── track-prompt.bats ................. Tests for UserPromptSubmit hook\n│   ├── track-stop.bats ................... Tests for Stop hook (Fibonacci, levels, scoring)\n│   └── migrate-data.bats ................. Tests for schema migration\n├── docs/\n│   ├── getting-started.md ................. Nav parent: Getting Started\n│   ├── automation.md ...................... Nav parent: Automation\n│   ├── configuration.md ................... Nav parent: Configuration & Extensions\n│   ├── integrations.md .................... Nav parent: Integrations\n│   ├── user-stories.md .................... Nav parent: User Stories\n│   └── windows-support.md ................ Windows setup and adjustments\n├── _config.yml ............................ Jekyll configuration (just-the-docs theme; include: _worker.js/_redirects)\n├── _worker.js ............................. Cloudflare Pages advanced-mode Worker (markdown content negotiation)\n├── _redirects ............................. Cloudflare Pages rules (catch-all real 404)\n├── 404.md ................................. Custom 404 page (served by _redirects)\n├── llms.txt ............................... Agent-facing documentation index\n├── Gemfile ................................ Ruby dependencies\n├── index.md ............................... Website landing page\n├── .local/ ................................ Runtime data (gitignored)\n│   └── game-data.json .................... Usage data (created at runtime)\n├── CLAUDE.md .............................. Agent instructions\n├── PRIVACY.md ............................. Privacy policy\n├── LICENSE ................................ CC BY 4.0\n└── README.md .............................. This file\n```\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=OriNachum/claude-code-guide&type=Date)](https://www.star-history.com/#OriNachum/claude-code-guide&Date)\n\n## Contributing\n\nContributions welcome! The seven skills live at `skills/onboard/`, `skills/ask/`, `skills/introspect/`, `skills/game-mode/`, `skills/level-up/`, `skills/migrate-to-claude/`, and `skills/visualize-setup/`. Reference docs are in `skills/ask/references/` and hooks are in `hooks/`.\n\n## License\n\nCC BY 4.0 — see [LICENSE](LICENSE) for details.\n",
  "bytes": 15175,
  "sha": "cb8fdb7c5d673c37c3939015306d6209dac1400334874e05365db3cb4457d067",
  "repo_slug": "orinachum/onboarding-claude-code",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_orinachum_onboarding_claude_code_guide_15e17d82/readme"
}