docs: add Claude Code skill installation guide

Hidden knowledge = dead code + bad DX

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

docs/index.md

@@ -114,10 +114,12 @@ Core uses `.core/` directory for project configuration:
 - [Configuration](configuration.md) - All config options
 - [Examples](examples/) - Sample configurations
 
-## Framework
+## Claude Code Skill
 
-Core also provides a Go framework for building desktop applications:
+Install the skill to teach Claude Code how to use the Core CLI:
 
-- [Framework Overview](framework/overview.md)
+```bash
-- [Services](framework/services.md)
+curl -fsSL https://raw.githubusercontent.com/host-uk/core/main/.claude/skills/core/install.sh | bash
-- [Lifecycle](framework/lifecycle.md)
+```
+
+See [skill/](skill/) for details.

docs/skill/index.md

@@ -0,0 +1,35 @@
+# Claude Code Skill
+
+The `core` skill teaches Claude Code how to use the Core CLI effectively.
+
+## Installation
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/host-uk/core/main/.claude/skills/core/install.sh | bash
+```
+
+Or if you have the repo cloned:
+
+```bash
+./.claude/skills/core/install.sh
+```
+
+## What it does
+
+Once installed, Claude Code will:
+
+- Auto-invoke when working in host-uk repositories
+- Use `core` commands instead of raw `go`/`php`/`git` commands
+- Follow the correct patterns for testing, building, and releasing
+
+## Manual invocation
+
+Type `/core` in Claude Code to invoke the skill manually.
+
+## Updating
+
+Re-run the install command to update to the latest version.
+
+## Location
+
+Skills are installed to `~/.claude/skills/core/SKILL.md`.