refactor(agents): migrate universal skills from opencode to ~/.agents

Move tool-agnostic skills (memory, git-commit-push, dotfiles,
retrospective, create-skill) to home/dot_agents/ so OpenCode, Claude
Code, Cursor, and pi all discover them from ~/.agents/skills/.

OpenCode AGENTS.md slimmed to OC-specific rules (subagents,
context-mode) with a pointer to ~/.agents/AGENTS.md. Added
~/.claude/CLAUDE.md with @-import for Claude Code integration.

Author: ChipWolf

AGENTS.md

@@ -115,14 +115,15 @@ Deleting a file from the chezmoi source does **not** remove it from the target (
 
 ## Repo-specific conventions
 
+- **Universal agent definitions** – `home/dot_agents/` (→ `~/.agents/`). Cross-tool agent rules and skills shared by OpenCode, Claude Code, Cursor, and pi. Universal rules live in `home/dot_agents/AGENTS.md`; universal skills in `home/dot_agents/skills/`. Edit the chezmoi source, not the deployed files.
 - **Repo-local skills** – Shared project skills live under `.agents/skills/`.
 - **MCP server updates** – Load `.agents/skills/update-mcp-servers/SKILL.md` before changing `home/.chezmoidata/mcps/*.yaml`, `home/dot_cursor/mcp.json.tmpl`, or `home/dot_config/opencode/opencode.jsonc.tmpl`.
 - **Agent permission updates** – Load `.agents/skills/update-agent-permissions/SKILL.md` before changing `home/.chezmoidata/agent-permissions/*.yaml`, `schemas/agent-permissions.schema.json`, or OpenCode permission template rendering.
 - **Homebrew updates** – Load `.agents/skills/homebrew-management/SKILL.md` before changing `home/Brewfile.tmpl`, `home/Brewfile.ignore`, brew overlay data, brew-related chezmoiscripts, or `home/dot_scripts/executable_brew-review`.
 - **Zsh** – Primary config under `home/dot_config/zsh/`: `dot_zshrc`, `dot_zshenv`, `dot_zprofile`, `dot_zplugins`, `dot_zshrc.d/`, `dot_zfunctions/`, `dot_p10k.zsh`. Top-level `home/dot_zshenv` and `home/dot_profile` set `ZDOTDIR` / `XDG_CONFIG_HOME` and are sourced by the shell.
 - **Neovim** – `home/dot_config/nvim/` (LazyVim-style: `init.lua`, `lua/config/`, `lua/plugins/`).
 - **OpenCode** – `home/dot_config/opencode/opencode.jsonc.tmpl` (→ `~/.config/opencode/opencode.jsonc`). This is the global OpenCode config: model, MCP servers, permissions, etc. It is a chezmoi template (uses `.chezmoi.homeDir` for the Obsidian vault path). Edit the source here when updating OpenCode settings.
-- **OpenCode global agent rules** – `home/dot_config/opencode/AGENTS.md` (→ `~/.config/opencode/AGENTS.md`). Universal agent rules that apply across all OpenCode sessions and projects. Edit the source here and run `chezmoi apply`. Never edit `~/.config/opencode/AGENTS.md` directly.
+- **OpenCode-specific agent rules** – `home/dot_config/opencode/AGENTS.md` (→ `~/.config/opencode/AGENTS.md`). OpenCode-specific rules (context-mode routing, subagents, custom commands) that extend the universal rules in `~/.agents/AGENTS.md`. Edit the source here and run `chezmoi apply`. Never edit `~/.config/opencode/AGENTS.md` directly.
 - **mcpproxy** – `home/private_dot_mcpproxy/modify_mcp_config.json` (→ `~/.mcpproxy/mcp_config.json`). Renders the [smart-mcp-proxy/mcpproxy-go](https://github.com/smart-mcp-proxy/mcpproxy-go) config from `home/.chezmoidata/mcps/*.yaml` (same source of truth as Cursor and OpenCode). Installed via Homebrew tap `smart-mcp-proxy/mcpproxy` on macOS/Linux and via pinned GitHub release installer on private Windows systems. Use the `update-mcp-servers` skill when changing servers.
 - **pi MCP servers** – `home/dot_pi/agent/mcp.json.tmpl` (→ `~/.pi/agent/mcp.json`). Renders pi-facing MCP servers from the same `home/.chezmoidata/mcps/*.yaml` source of truth. Pi has no built-in MCP support, so the `pi` target is opt-in: only servers with `targets.pi.enabled: true` are emitted. Use the `update-mcp-servers` skill when changing servers.
 - **mise tools** – Declared in `home/dot_config/mise/config.toml.tmpl`. `home/.chezmoiscripts/run_onchange_after_mise_install.sh.tmpl` runs `mise install` whenever that config changes (hash-pinned via `include`/`sha256sum`), so adding/removing/repinning mise tools reconciles on `chezmoi apply` without re-running the full bootstrap. The bootstrap script still runs `mise install` on first provisioning; this onchange handles ongoing changes.

home/dot_agents/AGENTS.md

@@ -0,0 +1,61 @@
+# Global agent rules
+
+These rules apply to every coding session, across every project.
+
+---
+
+## Always active
+
+These constraints are unconditional. Apply them without being asked.
+
+- **No em dashes.** Use commas, colons, or restructure the sentence. Never generate `—`, `---`, or `—`.
+- **Never guess schemas or APIs.** Read the authoritative source first (Go structs, official docs, or the project's own examples). Blog posts and AI-generated examples are not acceptable. If docs don't render, clone the repo and read the struct tags directly.
+- **Clone repos to read source.** Never curl GitHub API endpoints or fetch raw URLs. `git clone` first, then read.
+- **All Python through mise.** Never invoke `python`, `pip`, `uv`, or `uvx` directly. Use `mise x -- <command>` for all Python toolchain work.
+- **Never accept a limitation without investigating.** Keep working until the problem is actually solved. Suggesting workarounds as a final answer is not acceptable.
+- **Don't say "Docker containers."** Docker is a brand name, not a container type. Write "containers" or "OCI images" in prose. Action references like `docker/login-action` are fine as-is.
+
+---
+
+## Session close: mandatory
+
+After every non-trivial task, load the `retrospective` skill and follow it before closing out.
+
+---
+
+## Memory
+
+Global memory is `~/.agents/AGENTS.md` (source: `~/.local/share/chezmoi/home/dot_agents/AGENTS.md`).
+Local memory is the `AGENTS.md` in the current project root (or nearest ancestor).
+
+Never edit `~/.agents/AGENTS.md` directly; it is chezmoi-managed. Load the `memory` skill for all writes.
+
+For rules specific to the chezmoi dotfiles repo itself, the target is `~/.local/share/chezmoi/AGENTS.md`.
+
+When updating any memory file: review nearby rules for contradictions, duplication, and scope conflicts; reconcile in the same edit. Keep cross-cutting rules in global memory; keep project-specific rules in local memory.
+
+---
+
+## Git and commits
+
+- Load `git-commit-push` for commit or push operations.
+- Before committing, run `git diff --staged` and confirm the change is atomic and in-scope. Do not commit unrelated modifications.
+- Commit message format: `type(scope): description`. Types: `feat`, `fix`, `chore`. Check `git log --oneline` to match repo style.
+
+---
+
+## Shell discipline
+
+- Prefer the smallest atomic command that completes the immediate next step. Do not chain concerns across policy boundaries.
+- Keep source edits, `chezmoi apply`, and git operations as separate commands unless a later step strictly depends on the previous one within the same concern.
+- Destructive or policy-sensitive actions should be isolated so intent is easy to inspect.
+- Do not check whether a directory exists before using it. Attempt the operation; create the directory if it fails.
+- On Windows, when admin rights are required, launch elevated commands with `Start-Process -Verb RunAs` instead of failing back to manual instructions.
+
+---
+
+## Toolchain
+
+- When a CLI can be managed by `mise`, run it through `mise x -- <command>`. Do not invoke managed tools directly.
+- When `chezmoi apply` triggers a brew bundle run (via an onchange script), treat it as fire-and-forget once the apply succeeds.
+- If `chezmoi apply` fails because an unrelated template needs a secret (e.g. Bitwarden locked), apply only the file you need with `chezmoi apply <target-path>` to bypass the failing template.

…de/skills/create-opencode-skill/SKILL.md …/dot_agents/skills/create-skill/SKILL.mdhome/dot_config/opencode/skills/create-opencode-skill/SKILL.md renamed to home/dot_agents/skills/create-skill/SKILL.md home/dot_config/opencode/skills/create-opencode-skill/SKILL.md renamed to home/dot_agents/skills/create-skill/SKILL.md

@@ -1,18 +1,18 @@
 ---
-name: create-opencode-skill
-description: Author and maintain OpenCode skills with valid frontmatter, correct placement, and global-memory integration. Use when asked to create, update, or document a skill workflow.
+name: create-skill
+description: Author and maintain agent skills with valid frontmatter, correct placement, and global-memory integration. Use when asked to create, update, or document a skill workflow.
 ---
 
 ## Purpose
 
-Create high-quality OpenCode skills that are discoverable, accurate, and maintainable.
+Create high-quality agent skills that are discoverable, accurate, and maintainable.
 
 ## Canonical references
 
 Before writing or changing a skill, verify format and behavior from official docs:
 
 - <https://opencode.ai/docs/skills/>
-- Use existing local skills in `~/.config/opencode/skills/*/SKILL.md` as style references.
+- Use existing skills in `~/.agents/skills/*/SKILL.md` as style references.
 
 Do not invent frontmatter fields or naming rules.
 
@@ -40,14 +40,13 @@ Description constraints:
 ## Authoring workflow
 
 1. Identify target location:
-   - Global skills: `~/.local/share/chezmoi/home/dot_config/opencode/skills/`
+   - Universal skills (shared across all coding agents): `~/.local/share/chezmoi/home/dot_agents/skills/`
+   - Tool-specific skills (e.g. OpenCode-only): `~/.local/share/chezmoi/home/dot_config/<tool>/skills/`
 2. Create skill directory and `SKILL.md`.
 3. Write concise instructions with concrete command patterns and guardrails.
 4. Include a self-improvement loop section so the skill is updated when better steps are found.
-5. If introducing a new recurring workflow skill, update global memory in `~/.local/share/chezmoi/home/dot_config/opencode/AGENTS.md`:
-   - Add row in the skills table.
-   - Add a short trigger line in the relevant section.
-6. Verify deployed files under `~/.config/opencode/...` after `chezmoi apply`.
+5. If the skill introduces rules that belong in global memory, update `~/.local/share/chezmoi/home/dot_agents/AGENTS.md`.
+6. Verify deployed files after `chezmoi apply`.
 
 ## Content quality checklist
 
@@ -60,9 +59,9 @@ Description constraints:
 ## Guardrails
 
 - For AGENTS.md edits, load and follow the `memory` skill first.
-- Do not edit `~/.config/opencode/AGENTS.md` directly, update chezmoi source and apply.
+- Do not edit deployed files directly, update chezmoi source and apply.
 - Do not remove existing memory rules unless explicitly requested.
 
 ## Self-improvement loop
 
-After each skill-authoring task, capture any improvements in structure, validation, or memory-integration steps by updating this file: `home/dot_config/opencode/skills/create-opencode-skill/SKILL.md`.
+After each skill-authoring task, capture any improvements in structure, validation, or memory-integration steps by updating this file: `home/dot_agents/skills/create-skill/SKILL.md`.

…config/opencode/skills/dotfiles/SKILL.md home/dot_agents/skills/dotfiles/SKILL.mdhome/dot_config/opencode/skills/dotfiles/SKILL.md renamed to home/dot_agents/skills/dotfiles/SKILL.md home/dot_config/opencode/skills/dotfiles/SKILL.md renamed to home/dot_agents/skills/dotfiles/SKILL.md

@@ -31,8 +31,10 @@ Use this skill as a dispatcher:
 
 - **Zsh:** `home/dot_config/zsh/` — `dot_zshrc`, `dot_zshenv`, `dot_zprofile`, `dot_zplugins`, `dot_zshrc.d/`, `dot_zfunctions/`, `dot_p10k.zsh`. Top-level `home/dot_zshenv` and `home/dot_profile` set `ZDOTDIR`/`XDG_CONFIG_HOME`.
 - **Neovim:** `home/dot_config/nvim/` (LazyVim-style).
+- **Universal agent rules:** `home/dot_agents/AGENTS.md` — edit here, not at `~/.agents/AGENTS.md`.
+- **Universal agent skills:** `home/dot_agents/skills/` — shared across all coding agents.
 - **OpenCode config:** `home/dot_config/opencode/opencode.jsonc.tmpl`.
-- **OpenCode global rules:** `home/dot_config/opencode/AGENTS.md` — edit here, not at `~/.config/opencode/AGENTS.md`.
+- **OpenCode-specific rules:** `home/dot_config/opencode/AGENTS.md` — OpenCode-only rules and context-mode routing.
 - **OpenCode data overlays:** `home/.chezmoidata/agent-permissions/` and `home/.chezmoidata/mcps/`.
 - **WezTerm:** `home/dot_config/wezterm/wezterm.lua` — Windows only (ignored on non-Windows).
 - **Scripts:** `home/dot_scripts/` — deployed to `~/.scripts/` which is on PATH.

…opencode/skills/git-commit-push/SKILL.md …t_agents/skills/git-commit-push/SKILL.mdhome/dot_config/opencode/skills/git-commit-push/SKILL.md renamed to home/dot_agents/skills/git-commit-push/SKILL.md home/dot_config/opencode/skills/git-commit-push/SKILL.md renamed to home/dot_agents/skills/git-commit-push/SKILL.md

@@ -111,6 +111,6 @@ After each use, run this loop before ending the task:
    - Credential-helper failures (`gh: command not found`, helper not executable in shell).
    - Rebase/push branches not handled by the current instructions.
 2. If a pattern appears, update this skill in chezmoi source:
-   - `home/dot_config/opencode/skills/git-commit-push/SKILL.md`
+   - `home/dot_agents/skills/git-commit-push/SKILL.md`
 3. Keep updates concrete, command-level, and minimal.
 4. Re-run the failing step once to validate the skill update.

…t_config/opencode/skills/memory/SKILL.md home/dot_agents/skills/memory/SKILL.mdhome/dot_config/opencode/skills/memory/SKILL.md renamed to home/dot_agents/skills/memory/SKILL.md home/dot_config/opencode/skills/memory/SKILL.md renamed to home/dot_agents/skills/memory/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: memory
-description: Persist rules, conventions, or lessons into AGENTS.md files so future sessions benefit. Load this skill before writing to global memory (~/.config/opencode/AGENTS.md) or any project AGENTS.md.
+description: Persist rules, conventions, or lessons into AGENTS.md files so future sessions benefit. Load this skill before writing to global memory (~/.agents/AGENTS.md) or any project AGENTS.md.
 ---
 
 ## The two memory targets
 
-**Global memory** (`~/.config/opencode/AGENTS.md`) — rules that apply to every OpenCode session across every project.
-Source: `~/.local/share/chezmoi/home/dot_config/opencode/AGENTS.md`
+**Global memory** (`~/.agents/AGENTS.md`) — rules that apply to every coding session across every project.
+Source: `~/.local/share/chezmoi/home/dot_agents/AGENTS.md`
 
 **Local memory** (`AGENTS.md` in the current project root or nearest ancestor) — rules specific to that codebase.
 Source: edit that file directly; it is not managed by chezmoi.
@@ -15,14 +15,14 @@ For rules specific to the chezmoi dotfiles repo itself, use `~/.local/share/chez
 
 ## Updating global memory
 
-1. Read `~/.local/share/chezmoi/home/dot_config/opencode/AGENTS.md`.
+1. Read `~/.local/share/chezmoi/home/dot_agents/AGENTS.md`.
 2. Edit it with the Edit tool. Never write from scratch; always preserve existing content.
 3. Run `chezmoi apply` to deploy.
 4. Commit and push:
 
    ```sh
-   git -C ~/.local/share/chezmoi add home/dot_config/opencode/AGENTS.md
-   git -C ~/.local/share/chezmoi commit -m "chore(opencode): <description>"
+   git -C ~/.local/share/chezmoi add home/dot_agents/AGENTS.md
+   git -C ~/.local/share/chezmoi commit -m "chore(agents): <description>"
    git -C ~/.local/share/chezmoi pull --rebase
    git -C ~/.local/share/chezmoi push
    ```
@@ -35,7 +35,7 @@ For rules specific to the chezmoi dotfiles repo itself, use `~/.local/share/chez
 
 ## Quality rules
 
-- Never edit `~/.config/opencode/AGENTS.md` directly; it is managed by chezmoi.
+- Never edit `~/.agents/AGENTS.md` directly; it is managed by chezmoi.
 - Never remove existing rules unless explicitly instructed.
 - Review nearby rules for contradictions, duplication, and scope conflicts; reconcile in the same edit.
 - Keep rules at the narrowest correct scope: cross-cutting rules in global memory, project-specific rules in local memory.

…g/opencode/skills/retrospective/SKILL.md …dot_agents/skills/retrospective/SKILL.mdhome/dot_config/opencode/skills/retrospective/SKILL.md renamed to home/dot_agents/skills/retrospective/SKILL.md home/dot_config/opencode/skills/retrospective/SKILL.md renamed to home/dot_agents/skills/retrospective/SKILL.md

@@ -0,0 +1 @@
+@~/.agents/AGENTS.md