docs(plugin): document Claude Code plugin install + skill inventory

Author: AlemTuzlak

README.md

@@ -193,6 +193,39 @@ Here are a few useful resources to help you get started:
 
 - Want to contribute but not sure how? [Join our Discord](https://discord.gg/6dffbvGU3D) and we'll help you out!
 
+## Install as a Claude Code plugin
+
+The CopilotKit monorepo doubles as a Claude Code plugin — all 9 skills (3 package meta-skills + 6 lifecycle journey skills) are available once installed.
+
+Add the repo as a Claude Code marketplace:
+
+```bash
+claude plugin marketplace add https://github.com/CopilotKit/CopilotKit
+claude plugin install copilotkit
+```
+
+Skills are discovered from `skills/<slug>/SKILL.md` at the repo root. The three package meta-skills (`runtime`, `react-core`, `a2ui-renderer`) are **generated mirrors** of the source-of-truth files at `packages/<pkg>/skills/<pkg>/` — do not edit the mirror directly. To update content, edit the source under `packages/*/skills/` and run:
+
+```bash
+pnpm sync:plugin-skills
+```
+
+A lefthook pre-commit check (`pnpm check:plugin-skills`) rejects commits that drift the mirror. The plugin version is pinned to `packages/runtime/package.json` and is also kept in sync by the same script.
+
+### Skill inventory
+
+| Slug | Type | Source |
+| --- | --- | --- |
+| `runtime` | core | `packages/runtime/skills/runtime/` |
+| `react-core` | framework | `packages/react-core/skills/react-core/` |
+| `a2ui-renderer` | framework | `packages/a2ui-renderer/skills/a2ui-renderer/` |
+| `0-to-working-chat` | lifecycle | `skills/0-to-working-chat/` |
+| `spa-without-runtime` | lifecycle | `skills/spa-without-runtime/` |
+| `go-to-production` | lifecycle | `skills/go-to-production/` |
+| `scale-to-multi-agent` | lifecycle | `skills/scale-to-multi-agent/` |
+| `v1-to-v2-migration` | lifecycle | `skills/v1-to-v2-migration/` |
+| `debug-and-troubleshoot` | lifecycle | `skills/debug-and-troubleshoot/` |
+
 ## 📄 License
 
 This repository's source code is available under the [MIT License](https://github.com/CopilotKit/CopilotKit/blob/main/LICENSE).