docs: improve README with better structure and documentation links

- Add sections for Claude Code and non-Claude installation
- Link components to skill files in this repo
- Add documentation section with all guides
- Add requirements section
- Add updating section

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: auge2u

README.md

@@ -6,14 +6,28 @@ A comprehensive, Claude-native developer environment toolkit.
 
 ## Quick Start
 
-```
+### With Claude Code
+
+```bash
 # In Claude Code, simply say:
 "Set up my dev environment for Claude"
 
 # Or invoke the skill directly:
 Skill: setup-claude-dev-kit
 ```
 
+### Without Claude Code
+
+```bash
+# One-liner installation
+curl -fsSL https://raw.githubusercontent.com/claude-dev-kit/claude-dev-kit/main/install.sh | bash
+
+# Or clone and run
+git clone https://github.com/claude-dev-kit/claude-dev-kit.git
+cd claude-dev-kit
+./install.sh
+```
+
 ## Bundles
 
 | Bundle | Components | Use Case |
@@ -24,14 +38,14 @@ Skill: setup-claude-dev-kit
 
 ## Components
 
-| Component | Description |
-|-----------|-------------|
-| [cdk-shell](https://github.com/claude-dev-kit/cdk-shell) | Zsh, Powerlevel10k, completions, aliases |
-| [cdk-editor](https://github.com/claude-dev-kit/cdk-editor) | VS Code/Cursor settings, extensions |
-| [cdk-git](https://github.com/claude-dev-kit/cdk-git) | Hooks, commit templates, PR workflows |
-| [cdk-templates](https://github.com/claude-dev-kit/cdk-templates) | CLAUDE.md templates, project scaffolds |
-| [cdk-quality](https://github.com/claude-dev-kit/cdk-quality) | Linting, testing, review automation |
-| [cdk-memory](https://github.com/claude-dev-kit/cdk-memory) | Context/conversation management |
+| Component | Skill | Description |
+|-----------|-------|-------------|
+| Shell | [`setup-cdk-shell`](skills/shell/SKILL.md) | Zsh, Powerlevel10k, completions, aliases |
+| Editor | [`setup-cdk-editor`](skills/editor/SKILL.md) | VS Code/Cursor settings, extensions |
+| Git | [`setup-cdk-git`](skills/git/SKILL.md) | Hooks, commit templates, PR workflows |
+| Templates | [`setup-cdk-templates`](skills/templates/SKILL.md) | CLAUDE.md templates, project scaffolds |
+| Quality | [`setup-cdk-quality`](skills/quality/SKILL.md) | Linting, CI workflows, review automation |
+| Memory | [`setup-cdk-memory`](skills/memory/SKILL.md) | Context management, session export |
 
 ## Installation Modes
 
@@ -41,27 +55,46 @@ Opinionated defaults, fast setup, minimal questions.
 ### Adaptation (Existing Setup)
 Respects your config, shows diffs, backs up before changes.
 
-## Manual Installation
-
-If you prefer not to use Claude Code:
+## Install Script Options
 
 ```bash
-# Interactive installation
-curl -fsSL https://raw.githubusercontent.com/claude-dev-kit/claude-dev-kit/main/install.sh | bash
-
-# Or with options
-./install.sh --bundle standard           # Skip prompts, use standard bundle
-./install.sh --bundle minimal --non-interactive   # Fully automated
+./install.sh [options]
 ```
 
-### Options
-
 | Flag | Description |
 |------|-------------|
 | `--bundle <name>` | Choose bundle: minimal, standard, full |
 | `--non-interactive` | Skip all prompts, use defaults |
 | `--help` | Show help |
 
+## Updating
+
+```bash
+# With Claude Code
+claude "update-claude-dev-kit"
+
+# Or re-run install script (safe to run multiple times)
+./install.sh
+```
+
+## Documentation
+
+- [Skills Reference](skills/README.md) - All available skills
+- [Testing Guide](docs/TESTING.md) - How to test components
+- [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and fixes
+- [Contributing](CONTRIBUTING.md) - How to contribute
+- [Changelog](CHANGELOG.md) - Version history
+
+## Requirements
+
+- macOS 12+ or Ubuntu 22.04+
+- git
+- curl
+
+Optional:
+- [Claude Code](https://claude.ai/code) - For the full interactive experience
+- VS Code or Cursor - For editor component
+
 ## License
 
 MIT