feat: deploy skills pipeline with provider adapter pattern

docs/VISION.md

@@ -28,7 +28,8 @@ Designed to start as a personal homelab tool and grow into something shareable w
 
 ```
 this repo (global defaults)
-    ├── install.sh → ~/.agents/skills/  (cross-client skills, all providers)
+    ├── install.sh → ~/.agents/skills/  (canonical skills location)
+    ├── install.sh → ~/.claude/skills/  (symlink → ~/.agents/skills/, Claude Code adapter)
     └── install.sh → ~/.claude/         (Claude Code config + content)
 
 project repo (local overrides)
@@ -43,17 +44,16 @@ Projects consume from this repo by pulling updates via `sync.sh` (chunk 6). Unti
 ai-development/
 ├── docs/                        # Workflow artifacts and issues (prd/, ard/, bug/, notes/, adr/, issues/) + research/ (raw research audit trail)
 ├── .agents/                     # Agent Skills standard location (provider-agnostic)
-│   └── skills/                  # SKILL.md files — read natively by Claude Code, Copilot, Cursor, etc.
+│   └── skills/                  # SKILL.md files — canonical source, deployed to ~/.agents/skills/
 ├── core/                        # Provider-agnostic source of truth
 │   ├── instructions/            # AI behavior definitions (plain markdown)
 │   ├── agents/                  # Agent role definitions
 │   ├── workflows/               # Workflow definitions
 │   └── prompts/                 # Reusable prompt templates
 ├── providers/                   # Provider-specific adapters
-│   ├── claude-code/             # CLAUDE.md, settings.json
+│   ├── claude-code/             # CLAUDE.md, settings.json, provider-manifest.sh
 │   └── copilot/                 # copilot-instructions.md, hooks, agents adapter
 ├── templates/                   # Project scaffolding templates
-├── skills-lock.json             # Tracks installed skills and their sources/hashes
 └── scripts/
     ├── deploy-manifest.sh       # Source→target mappings; sourced by install.sh and sync.sh
     ├── install.sh               # Deploys to ~/.agents/skills/, ~/.claude/, etc.
@@ -65,7 +65,8 @@ ai-development/
 
 `install.sh` is a **deployer**, not a composer. It does not concatenate content into a single file. Instead:
 
-- `.agents/skills/` → `~/.agents/skills/` — user-level cross-client skills (read by Claude Code, Copilot, Cursor, etc.)
+- `.agents/skills/` → `~/.agents/skills/` — canonical skills location; each skill dir is replaced individually (parent not wiped, user-added skills preserved)
+- Provider adapters declared in `providers/*/provider-manifest.sh` — symlinks from the provider's skill path to `~/.agents/skills/`; e.g. Claude Code gets `~/.claude/skills/ → ~/.agents/skills/` because it reads `~/.claude/skills/` natively. Providers that read `~/.agents/skills/` directly need no adapter.
 - `core/` → `~/.claude/core/` — workflows, prompts, agent definitions; agent reads on demand
 - `providers/claude-code/settings.json` → `~/.claude/settings.json`
 - Writes a lean `~/.claude/CLAUDE.md` — universal rules only, plus pointers to where detailed content lives
@@ -88,7 +89,7 @@ This repo has a `CLAUDE.md` at its root — a meta file that tells Claude how to
 
 `core/` is never tool-specific. `providers/` is never shared. When adding a new provider, write an adapter in `providers/<name>/` that translates core content into the tool's expected format and location. The core content itself does not change.
 
-Skills are the strongest shared primitive — both Claude Code and GitHub Copilot use the `SKILL.md` format and follow the [Agent Skills open standard](https://agentskills.io).
+Skills are the strongest shared primitive — the `SKILL.md` format and [Agent Skills open standard](https://agentskills.io) are cross-provider. Providers that don't read `~/.agents/skills/` natively declare a symlink adapter in `providers/<name>/provider-manifest.sh`; `install.sh` discovers and wires these up automatically.
 
 ### Architectural decisions