Update skill references in README files and add new skills to deprecated and personal sections

README.md

@@ -10,49 +10,49 @@ If you want to keep up with changes to these skills, and any new ones I create,
 
 Skills I use daily for code work.
 
-- **diagnose** — Disciplined diagnosis loop for hard bugs and performance regressions: reproduce → minimise → hypothesise → instrument → fix → regression-test.
+- **[diagnose](./skills/engineering/diagnose/SKILL.md)** — Disciplined diagnosis loop for hard bugs and performance regressions: reproduce → minimise → hypothesise → instrument → fix → regression-test.
 
   ```
   npx skills@latest add mattpocock/skills/diagnose
   ```
 
-- **domain-model** — Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates `CONTEXT.md` and ADRs inline.
+- **[domain-model](./skills/engineering/domain-model/SKILL.md)** — Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates `CONTEXT.md` and ADRs inline.
 
   ```
   npx skills@latest add mattpocock/skills/domain-model
   ```
 
-- **github-triage** — Triage GitHub issues through a label-based state machine.
+- **[github-triage](./skills/engineering/github-triage/SKILL.md)** — Triage GitHub issues through a label-based state machine.
 
   ```
   npx skills@latest add mattpocock/skills/github-triage
   ```
 
-- **improve-codebase-architecture** — Find deepening opportunities in a codebase, informed by the domain language in `CONTEXT.md` and the decisions in `docs/adr/`.
+- **[improve-codebase-architecture](./skills/engineering/improve-codebase-architecture/SKILL.md)** — Find deepening opportunities in a codebase, informed by the domain language in `CONTEXT.md` and the decisions in `docs/adr/`.
 
   ```
   npx skills@latest add mattpocock/skills/improve-codebase-architecture
   ```
 
-- **tdd** — Test-driven development with a red-green-refactor loop. Builds features or fixes bugs one vertical slice at a time.
+- **[tdd](./skills/engineering/tdd/SKILL.md)** — Test-driven development with a red-green-refactor loop. Builds features or fixes bugs one vertical slice at a time.
 
   ```
   npx skills@latest add mattpocock/skills/tdd
   ```
 
-- **to-issues** — Break any plan, spec, or PRD into independently-grabbable GitHub issues using vertical slices.
+- **[to-issues](./skills/engineering/to-issues/SKILL.md)** — Break any plan, spec, or PRD into independently-grabbable GitHub issues using vertical slices.
 
   ```
   npx skills@latest add mattpocock/skills/to-issues
   ```
 
-- **to-prd** — Turn the current conversation context into a PRD and submit it as a GitHub issue. No interview — just synthesizes what you've already discussed.
+- **[to-prd](./skills/engineering/to-prd/SKILL.md)** — Turn the current conversation context into a PRD and submit it as a GitHub issue. No interview — just synthesizes what you've already discussed.
 
   ```
   npx skills@latest add mattpocock/skills/to-prd
   ```
 
-- **zoom-out** — Tell the agent to zoom out and give broader context or a higher-level perspective on an unfamiliar section of code.
+- **[zoom-out](./skills/engineering/zoom-out/SKILL.md)** — Tell the agent to zoom out and give broader context or a higher-level perspective on an unfamiliar section of code.
 
   ```
   npx skills@latest add mattpocock/skills/zoom-out
@@ -62,19 +62,19 @@ Skills I use daily for code work.
 
 General workflow tools, not code-specific.
 
-- **caveman** — Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler while keeping full technical accuracy.
+- **[caveman](./skills/productivity/caveman/SKILL.md)** — Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler while keeping full technical accuracy.
 
   ```
   npx skills@latest add mattpocock/skills/caveman
   ```
 
-- **grill-me** — Get relentlessly interviewed about a plan or design until every branch of the decision tree is resolved.
+- **[grill-me](./skills/productivity/grill-me/SKILL.md)** — Get relentlessly interviewed about a plan or design until every branch of the decision tree is resolved.
 
   ```
   npx skills@latest add mattpocock/skills/grill-me
   ```
 
-- **write-a-skill** — Create new skills with proper structure, progressive disclosure, and bundled resources.
+- **[write-a-skill](./skills/productivity/write-a-skill/SKILL.md)** — Create new skills with proper structure, progressive disclosure, and bundled resources.
 
   ```
   npx skills@latest add mattpocock/skills/write-a-skill
@@ -84,25 +84,25 @@ General workflow tools, not code-specific.
 
 Tools I keep around but rarely use.
 
-- **git-guardrails-claude-code** — Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, etc.) before they execute.
+- **[git-guardrails-claude-code](./skills/misc/git-guardrails-claude-code/SKILL.md)** — Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, etc.) before they execute.
 
   ```
   npx skills@latest add mattpocock/skills/git-guardrails-claude-code
   ```
 
-- **migrate-to-shoehorn** — Migrate test files from `as` type assertions to @total-typescript/shoehorn.
+- **[migrate-to-shoehorn](./skills/misc/migrate-to-shoehorn/SKILL.md)** — Migrate test files from `as` type assertions to @total-typescript/shoehorn.
 
   ```
   npx skills@latest add mattpocock/skills/migrate-to-shoehorn
   ```
 
-- **scaffold-exercises** — Create exercise directory structures with sections, problems, solutions, and explainers.
+- **[scaffold-exercises](./skills/misc/scaffold-exercises/SKILL.md)** — Create exercise directory structures with sections, problems, solutions, and explainers.
 
   ```
   npx skills@latest add mattpocock/skills/scaffold-exercises
   ```
 
-- **setup-pre-commit** — Set up Husky pre-commit hooks with lint-staged, Prettier, type checking, and tests.
+- **[setup-pre-commit](./skills/misc/setup-pre-commit/SKILL.md)** — Set up Husky pre-commit hooks with lint-staged, Prettier, type checking, and tests.
 
   ```
   npx skills@latest add mattpocock/skills/setup-pre-commit