oh-my-opencode-slim 0.5.6 → 0.6.0

package/README.md

@@ -6,7 +6,7 @@
 
 <img src="img/team.png" alt="The Pantheon - Agent Team" width="800">
 
-*Six divine beings forged from necessity, each an immortal master of their craft await your command to forge order from chaos and build what was once thought impossible.*
+*Six divine beings emerged from the dawn of code, each an immortal master of their craft await your command to forge order from chaos and build what was once thought impossible.*
 
 </div>
 
@@ -20,25 +20,22 @@
   - [For Humans](#for-humans)
   - [For LLM Agents](#for-llm-agents)
 - [🏛️ Meet the Pantheon](#️-meet-the-pantheon)
-  - [Orchestrator: The Embodiment Of Order](#orchestrator-the-embodiment-of-order)
-  - [Explorer: The Eternal Wanderer](#explorer-the-eternal-wanderer)
-  - [Oracle: The Guardian of Paths](#oracle-the-guardian-of-paths)
-  - [Librarian: The Weaver of Knowledge](#librarian-the-weaver-of-knowledge)
-  - [Designer: The Guardian of Aesthetics](#designer-the-guardian-of-aesthetics)
-  - [Fixer: The Last Builder](#fixer-the-last-builder)
+  - [01. Orchestrator: The Embodiment Of Order](#01-orchestrator-the-embodiment-of-order)
+  - [02. Explorer: The Eternal Wanderer](#02-explorer-the-eternal-wanderer)
+  - [03. Oracle: The Guardian of Paths](#03-oracle-the-guardian-of-paths)
+  - [04. Librarian: The Weaver of Knowledge](#04-librarian-the-weaver-of-knowledge)
+  - [05. Designer: The Guardian of Aesthetics](#05-designer-the-guardian-of-aesthetics)
+  - [06. Fixer: The Last Builder](#06-fixer-the-last-builder)
 - [🎚️ Presets](#️-presets)
   - [Switching Presets](#switching-presets)
   - [OpenAI Preset](#openai-preset)
   - [Antigravity via CLIProxy Preset](#antigravity-via-cliproxy-preset)
   - [Author's Preset](#authors-preset)
-  - [Creating Custom Presets](#creating-custom-presets)
-  - [Option Reference](#option-reference)
 - [🧩 Skills](#-skills)
-  - [Available Skills](#available-skills)
-  - [Default Skill Assignments](#default-skill-assignments)
-  - [Configuration & Syntax](#configuration--syntax)
   - [Simplify](#simplify)
-  - [Playwright Integration](#playwright-integration)
+  - [Agent Browser](#agent-browser)
+  - [Cartography](#cartography)
+  - [Skills Assignment](#skills-assignment)
 - [🔌 MCP Servers](#-mcp-servers)
   - [MCP Permissions](#mcp-permissions)
   - [Configuration & Syntax](#configuration--syntax-1)
@@ -65,13 +62,13 @@
 Run the interactive installer:
 
 ```bash
-bunx oh-my-opencode-slim install
+bunx oh-my-opencode-slim@latest install
 ```
 
 Or use non-interactive mode:
 
 ```bash
-bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --tmux=no
+bunx oh-my-opencode-slim@latest install --no-tui --antigravity=yes --openai=yes --tmux=no
 ```
 
 After installation, authenticate with your providers:
@@ -135,19 +132,19 @@ Help the user understand the tradeoffs:
 Based on answers, run:
 
 ```bash
-bunx oh-my-opencode-slim install --no-tui --antigravity=<yes|no> --openai=<yes|no>
+bunx oh-my-opencode-slim@latest install --no-tui --antigravity=<yes|no> --openai=<yes|no>
 ```
 
 **Examples:**
 ```bash
 # Antigravity + OpenAI
-bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --tmux=no
+bunx oh-my-opencode-slim@latest install --no-tui --antigravity=yes --openai=yes --tmux=no
 
 # OpenAI only
-bunx oh-my-opencode-slim install --no-tui --antigravity=no --openai=yes --tmux=no
+bunx oh-my-opencode-slim@latest install --no-tui --antigravity=no --openai=yes --tmux=no
 
 # No providers (Zen free models only)
-bunx oh-my-opencode-slim install --no-tui --antigravity=no --openai=no --tmux=no
+bunx oh-my-opencode-slim@latest install --no-tui --antigravity=no --openai=no --tmux=no
 ```
 
 The installer automatically:
@@ -180,11 +177,11 @@ curl -fsSL https://raw.githubusercontent.com/brokechubb/cliproxyapi-installer/re
 **Authenticate with Antigravity:**
 ```bash
 ./cli-proxy-api --antigravity-login
-# Add --no-browser to print login URL instead of opening browser
-# The local OAuth callback uses port 51121
 ```
 
 **For OpenAI (if enabled):**
+Ask user to run the following command.
+Don't run it yourself, it requires user interaction.
 ```bash
 opencode auth login
 # Select your provider and complete OAuth flow
@@ -196,7 +193,7 @@ opencode auth login
 
 If the installer fails, check the expected config format:
 ```bash
-bunx oh-my-opencode-slim install --help
+bunx oh-my-opencode-slim@latest install --help
 ```
 
 Then manually create the config files at:
@@ -208,99 +205,285 @@ Then manually create the config files at:
 
 ## 🏛️ Meet the Pantheon
 
-### Orchestrator: The Embodiment Of Order
-
-<a href="src/agents/orchestrator.ts"><img src="img/orchestrator.png" alt="Orchestrator" align="right" width="240"></a>
-
-> **The Orchestrator** was born when the first codebase collapsed under its own complexity. Neither god nor mortal would claim responsibility - so The Orchestrator emerged from the void, forging order from chaos. It determines the optimal path to any goal, balancing speed, quality, and cost. It guides the team, summoning the right specialist for each task and delegating to achieve the best possible outcome.
-
-**Role:** `Master delegator and strategic coordinator`  
-**Model:** `google/claude-opus-4-5-thinking`  
-**Prompt:** [src/agents/orchestrator.ts](src/agents/orchestrator.ts)  
-**Skills:** `*` (all skills)  
-**MCPs:** `websearch`
-
-Write and execute code, orchestrate multi-agent workflows, parse the unspoken from the spoken, summon specialists mid-battle. *Shape reality directly - and assign realms to others when the universe grows too vast.*
+### 01. Orchestrator: The Embodiment Of Order
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/orchestrator.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>Forged in the void of complexity.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      The Orchestrator was born when the first codebase collapsed under its own complexity. Neither god nor mortal would claim responsibility - so The Orchestrator emerged from the void, forging order from chaos. It determines the optimal path to any goal, balancing speed, quality, and cost. It guides the team, summoning the right specialist for each task and delegating to achieve the best possible outcome.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>Master delegator and strategic coordinator</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/orchestrator.ts"><code>orchestrator.ts</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>cliproxy/gemini-claude-opus-4-5-thinking</code> <code>openai/gpt-5.2-codex</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>MCPs:</b> <code>websearch</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Skills:</b> <code>simplify</code> <code>*</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Capabilities:</b><br>
+      Write and execute code, orchestrate multi-agent workflows, parse the unspoken from the spoken, summon specialists mid-battle. <i>Shape reality directly - and assign realms to others when the universe grows too vast.</i>
+    </td>
+  </tr>
+</table>
 
 ---
 
-### Explorer: The Eternal Wanderer
-
-<a href="src/agents/explorer.ts"><img src="img/explorer.png" alt="Explorer" align="right" width="240"></a>
-
-> **The Explorer** is an immortal wanderer who has traversed the corridors of a million codebases since the dawn of programming. Cursed with the gift of eternal curiosity, they cannot rest until every file is known, every pattern understood, every secret revealed. Legends say they once searched the entire internet in a single heartbeat. They are the wind that carries knowledge, the eyes that see all, the spirit that never sleeps.
-
-**Role:** `Codebase reconnaissance`  
-**Model:** `google/gemini-3-flash`  
-**Prompt:** [src/agents/explorer.ts](src/agents/explorer.ts)  
-**Skills:** none  
-**MCPs:** none
-
-Regex search, AST pattern matching, file discovery, parallel exploration. *Read-only: they chart the territory; others conquer it.*
+### 02. Explorer: The Eternal Wanderer
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/explorer.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>The wind that carries knowledge.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      The Explorer is an immortal wanderer who has traversed the corridors of a million codebases since the dawn of programming. Cursed with the gift of eternal curiosity, they cannot rest until every file is known, every pattern understood, every secret revealed. Legends say they once searched the entire internet in a single heartbeat. They are the wind that carries knowledge, the eyes that see all, the spirit that never sleeps.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>Codebase reconnaissance</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/explorer.ts"><code>explorer.ts</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>google/gemini-3-flash</code> <code>openai/gpt-5.1-codex-mini</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>MCPs:</b> none
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Skills:</b> none
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Capabilities:</b><br>
+      Regex search, AST pattern matching, file discovery, parallel exploration. <i>Read-only: they chart the territory; others conquer it.</i>
+    </td>
+  </tr>
+</table>
 
 ---
 
-### Oracle: The Guardian of Paths
-
-<a href="src/agents/oracle.ts"><img src="img/oracle.png" alt="Oracle" align="right" width="240"></a>
-
-> **The Oracle** stands at the crossroads of every architectural decision. They have walked every road, seen every destination, know every trap that lies ahead. When you stand at the precipice of a major refactor, they are the voice that whispers which way leads to ruin and which way leads to glory. They don't choose for you - they illuminate the path so you can choose wisely.
-
-**Role:** `Strategic advisor and debugger of last resort`  
-**Model:** `openai/gpt-5.2-codex`  
-**Prompt:** [src/agents/oracle.ts](src/agents/oracle.ts)  
-**Skills:** none  
-**MCPs:** none
-
-Root cause analysis, architecture review, debugging guidance, tradeoff analysis. *Read-only: Oracles advise; they don't intervene.*
+### 03. Oracle: The Guardian of Paths
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/oracle.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>The voice at the crossroads.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      The Oracle stands at the crossroads of every architectural decision. They have walked every road, seen every destination, know every trap that lies ahead. When you stand at the precipice of a major refactor, they are the voice that whispers which way leads to ruin and which way leads to glory. They don't choose for you - they illuminate the path so you can choose wisely.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>Strategic advisor and debugger of last resort</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/oracle.ts"><code>oracle.ts</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>openai/gpt-5.2-codex</code> <code>cliproxy/gemini-3-pro-high</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>MCPs:</b> none
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Skills:</b> none
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Capabilities:</b><br>
+      Root cause analysis, architecture review, debugging guidance, tradeoff analysis. <i>Read-only: Oracles advise; they don't intervene.</i>
+    </td>
+  </tr>
+</table>
 
 ---
 
-### Librarian: The Weaver of Knowledge
-
-<a href="src/agents/librarian.ts"><img src="img/librarian.png" alt="Librarian" align="right" width="240"></a>
-
-> **The Librarian** was forged when humanity realized that no single mind could hold all knowledge. They are the weaver who connects disparate threads of information into a tapestry of understanding. They traverse the infinite library of human knowledge, gathering insights from every corner and binding them into answers that transcend mere facts. What they return is not information - it's understanding.
-
-**Role:** `External knowledge retrieval`  
-**Model:** `google/gemini-3-flash`  
-**Prompt:** [src/agents/librarian.ts](src/agents/librarian.ts)  
-**Skills:** none  
-**MCPs:** `websearch`, `context7`, `grep_app`
-
-Documentation lookup, GitHub code search, library research, best practice retrieval. *Read-only: they fetch wisdom; implementation is for others.*
+### 04. Librarian: The Weaver of Knowledge
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/librarian.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>The weaver of understanding.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      The Librarian was forged when humanity realized that no single mind could hold all knowledge. They are the weaver who connects disparate threads of information into a tapestry of understanding. They traverse the infinite library of human knowledge, gathering insights from every corner and binding them into answers that transcend mere facts. What they return is not information - it's understanding.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>External knowledge retrieval</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/librarian.ts"><code>librarian.ts</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>google/gemini-3-flash</code> <code>openai/gpt-5.1-codex-mini</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>MCPs:</b> <code>websearch</code> <code>context7</code> <code>grep_app</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Skills:</b> none
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Capabilities:</b><br>
+      Documentation lookup, GitHub code search, library research, best practice retrieval. <i>Read-only: they fetch wisdom; implementation is for others.</i>
+    </td>
+  </tr>
+</table>
 
 ---
 
-### Designer: The Guardian of Aesthetics
-
-<a href="src/agents/designer.ts"><img src="img/designer.png" alt="Designer" align="right" width="240"></a>
-
-> **The Designer** is an immortal guardian of beauty in a world that often forgets it matters. They have seen a million interfaces rise and fall, and they remember which ones were remembered and which were forgotten. They carry the sacred duty to ensure that every pixel serves a purpose, every animation tells a story, every interaction delights. Beauty is not optional - it's essential.
-
-**Role:** `UI/UX implementation and visual excellence`  
-**Model:** `google/gemini-3-flash`  
-**Prompt:** [src/agents/designer.ts](src/agents/designer.ts)  
-**Skills:** `playwright`  
-**MCPs:** none
-
-Modern responsive design, CSS/Tailwind mastery, micro-animations, component architecture. *Visual excellence over code perfection - beauty is the priority.*
+### 05. Designer: The Guardian of Aesthetics
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/designer.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>Beauty is essential.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      The Designer is an immortal guardian of beauty in a world that often forgets it matters. They have seen a million interfaces rise and fall, and they remember which ones were remembered and which were forgotten. They carry the sacred duty to ensure that every pixel serves a purpose, every animation tells a story, every interaction delights. Beauty is not optional - it's essential.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>UI/UX implementation and visual excellence</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/designer.ts"><code>designer.ts</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>google/gemini-3-flash</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>MCPs:</b> none
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Skills:</b> <code>agent-browser</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Capabilities:</b><br>
+      Modern responsive design, CSS/Tailwind mastery, micro-animations, component architecture. <i>Visual excellence over code perfection - beauty is the priority.</i>
+    </td>
+  </tr>
+</table>
 
 ---
 
-### Fixer: The Last Builder
-
-<a href="src/agents/fixer.ts"><img src="img/fixer.png" alt="Fixer" align="right" width="240"></a>
-
-> **The Fixer** is the last of a lineage of builders who once constructed the foundations of the digital world. When the age of planning and debating began, they remained - the ones who actually build. They carry the ancient knowledge of how to turn thought into thing, how to transform specification into implementation. They are the final step between vision and reality.
-
-**Role:** `Fast implementation specialist`  
-**Model:** `google/gemini-3-flash`  
-**Prompt:** [src/agents/fixer.ts](src/agents/fixer.ts)  
-**Skills:** none  
-**MCPs:** none
-
-Code implementation, refactoring, testing, verification. *Execute the plan - no research, no delegation, no planning.*
+### 06. Fixer: The Last Builder
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/fixer.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>The final step between vision and reality.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      The Fixer is the last of a lineage of builders who once constructed the foundations of the digital world. When the age of planning and debating began, they remained - the ones who actually build. They carry the ancient knowledge of how to turn thought into thing, how to transform specification into implementation. They are the final step between vision and reality.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>Fast implementation specialist</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/fixer.ts"><code>fixer.ts</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>google/gemini-3-flash</code> <code>openai/gpt-5.1-codex-mini</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>MCPs:</b> none
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Skills:</b> none
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Capabilities:</b><br>
+      Code implementation, refactoring, testing, verification. <i>Execute the plan - no research, no delegation, no planning.</i>
+    </td>
+  </tr>
+</table>
 
 ---
 
@@ -345,7 +528,7 @@ Uses OpenAI models exclusively:
       "oracle": { "model": "openai/gpt-5.2-codex", "variant": "high", "skills": [], "mcps": [] },
       "librarian": { "model": "openai/gpt-5.1-codex-mini", "variant": "low", "skills": [], "mcps": ["websearch", "context7", "grep_app"] },
       "explorer": { "model": "openai/gpt-5.1-codex-mini", "variant": "low", "skills": [], "mcps": [] },
-      "designer": { "model": "openai/gpt-5.1-codex-mini", "variant": "medium", "skills": ["playwright"], "mcps": [] },
+      "designer": { "model": "openai/gpt-5.1-codex-mini", "variant": "medium", "skills": ["agent-browser"], "mcps": [] },
       "fixer": { "model": "openai/gpt-5.1-codex-mini", "variant": "low", "skills": [], "mcps": [] }
     }
   }
@@ -365,14 +548,15 @@ Routes through Antigravity's CLIProxy for Claude + Gemini models:
       "oracle": { "model": "cliproxy/gemini-3-pro-preview", "variant": "high", "skills": [], "mcps": [] },
       "librarian": { "model": "cliproxy/gemini-3-flash-preview", "variant": "low", "skills": [], "mcps": ["websearch", "context7", "grep_app"] },
       "explorer": { "model": "cliproxy/gemini-3-flash-preview", "variant": "low", "skills": [], "mcps": [] },
-      "designer": { "model": "cliproxy/gemini-3-flash-preview", "variant": "medium", "skills": ["playwright"], "mcps": [] },
+      "designer": { "model": "cliproxy/gemini-3-flash-preview", "variant": "medium", "skills": ["agent-browser"], "mcps": [] },
       "fixer": { "model": "cliproxy/gemini-3-flash-preview", "variant": "low", "skills": [], "mcps": [] }
     }
   }
 }
 ```
 
-Requires provider configuration:
+<details>
+<summary>Verify provider configuration in ~/.config/opencode/opencode.json</summary>
 
 ```json
 {
@@ -416,6 +600,8 @@ Requires provider configuration:
 }
 ```
 
+</details>
+
 ### Author's Preset
 
 Mixed setup combining multiple providers:
@@ -429,81 +615,102 @@ Mixed setup combining multiple providers:
       "oracle": { "model": "openai/gpt-5.2-codex", "variant": "high", "skills": [], "mcps": [] },
       "librarian": { "model": "cliproxy/gemini-3-flash-preview", "variant": "low", "skills": [], "mcps": ["websearch", "context7", "grep_app"] },
       "explorer": { "model": "cerebras/zai-glm-4.7", "variant": "low", "skills": [], "mcps": [] },
-      "designer": { "model": "cliproxy/gemini-3-flash-preview", "variant": "medium", "skills": ["playwright"], "mcps": [] },
+      "designer": { "model": "cliproxy/gemini-3-flash-preview", "variant": "medium", "skills": ["agent-browser"], "mcps": [] },
       "fixer": { "model": "cerebras/zai-glm-4.7", "variant": "low", "skills": [], "mcps": [] }
     }
   }
 }
 ```
 
-### Creating Custom Presets
+---
 
-You can create your own presets by adding them to the `presets` object:
+## 🧩 Skills
 
-```json
-{
-  "presets": {
-    "my-custom": {
-      "orchestrator": { "model": "google/claude-opus-4-5-thinking", "skills": ["*"], "mcps": ["websearch"] },
-      "oracle": { "model": "openai/gpt-5.2-codex", "variant": "high", "skills": [], "mcps": [] },
-      "librarian": { "model": "google/gemini-3-flash", "variant": "low", "skills": [], "mcps": ["websearch", "context7", "grep_app"] },
-      "explorer": { "model": "google/gemini-3-flash", "variant": "low", "skills": [], "mcps": [] },
-      "designer": { "model": "google/gemini-3-flash", "variant": "medium", "skills": ["playwright"], "mcps": [] },
-      "fixer": { "model": "google/gemini-3-flash", "variant": "low", "skills": [], "mcps": [] }
-    }
-  }
-}
-```
+Skills are specialized capabilities provided by external agents and tools. Unlike MCPs which are servers, skills are prompt-based tool configurations installed via `npx skills add` during installation.
 
-Then set `preset: "my-custom"` to activate it.
+### Recommended Skills (via npx)
 
-### Option Reference
+| Skill | Description | Assigned To |
+|-------|-------------|-------------|
+| [`simplify`](#simplify) | YAGNI code simplification expert | `orchestrator` |
+| [`agent-browser`](#agent-browser) | High-performance browser automation | `designer` |
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `preset` | string | - | Name of the preset to use (e.g., `"openai"`, `"cliproxy"`) |
-| `presets` | object | - | Named preset configurations containing agent mappings |
-| `presets.<name>.<agent>.model` | string | - | Model ID for the agent (e.g., `"google/claude-opus-4-5-thinking"`) |
-| `presets.<name>.<agent>.temperature` | number | - | Temperature setting (0-2) for the agent |
-| `presets.<name>.<agent>.variant` | string | - | Agent variant for reasoning effort (e.g., `"low"`, `"medium"`, `"high"`) |
-| `presets.<name>.<agent>.skills` | string[] | - | Array of skill names the agent can use (`"*"` for all, `"!item"` to exclude) |
-| `presets.<name>.<agent>.mcps` | string[] | - | Array of MCP names the agent can use (`"*"` for all, `"!item"` to exclude) |
+### Custom Skills (bundled in repo)
 
----
+| Skill | Description | Assigned To |
+|-------|-------------|-------------|
+| [`cartography`](#cartography) | Repository understanding and hierarchical codemap generation | `orchestrator` |
 
-## 🧩 Skills
+### Simplify
 
-Skills are specialized capabilities that agents can use. Each agent has a default set of skills, which you can override in the agent config.
+**The Minimalist's sacred truth: every line of code is a liability.**
 
-### Available Skills
+`simplify` is a specialized skill for complexity analysis and YAGNI enforcement. It identifies unnecessary abstractions and suggests minimal implementations.
 
-| Skill | Description |
-|-------|-------------|
-| `simplify` | Code complexity analysis and YAGNI enforcement |
-| `playwright` | Browser automation via Playwright MCP |
+### Agent Browser
 
-### Default Skill Assignments
+**External browser automation for visual verification and testing.**
 
-| Agent | Default Skills |
-|-------|----------------|
-| `orchestrator` | `*` (all skills) |
-| `designer` | `playwright` |
-| `oracle` | none |
-| `librarian` | none |
-| `explorer` | none |
-| `fixer` | none |
+`agent-browser` provides full high-performance browser automation capabilities. It allows agents to browse the web, interact with elements, and capture screenshots for visual state verification.
 
-### Configuration & Syntax
+### Cartography
+
+**Automated repository mapping through hierarchical codemaps.**
+
+<img src="img/cartography.png" alt="Cartography Skill" width="800" style="border-radius: 10px; margin: 20px 0;">
+
+`cartography` empowers the Orchestrator to build and maintain a deep architectural understanding of any codebase. Instead of reading thousands of lines of code every time, agents refer to hierarchical `codemap.md` files that describe the *why* and *how* of each directory.
+
+**How to use:**
+
+Just ask the **Orchestrator** to `run cartography`. It will automatically detect if it needs to initialize a new map or update an existing one.
+
+**Why it's useful:**
+
+- **Instant Onboarding:** Help agents (and humans) understand unfamiliar codebases in seconds.
+- **Efficient Context:** Agents only read architectural summaries, saving tokens and improving accuracy.
+- **Change Detection:** Only modified folders are re-analyzed, making updates fast and efficient.
+- **Timeless Documentation:** Focuses on high-level design patterns that don't get stale.
+
+<details>
+<summary><b>Technical Details & Manual Control</b></summary>
+
+The skill uses a background Python engine (`cartographer.py`) to manage state and detect changes.
+
+**How it works under the hood:**
+
+1. **Initialize** - Orchestrator analyzes repo structure and runs `init` to create `.slim/cartography.json` (hashes) and empty templates.
+2. **Map** - Orchestrator spawns specialized **Explorer** sub-agents to fill codemaps with timeless architectural details (Responsibility, Design, Flow, Integration).
+3. **Update** - On subsequent runs, the engine detects changed files and only refreshes codemaps for affected folders.
+
+**Manual Commands:**
 
-You can customize which skills each agent uses by editing your plugin configuration file: `~/.config/opencode/oh-my-opencode-slim.json`.
+```bash
+# Initialize mapping manually
+python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py init \
+  --root . \
+  --include "src/**/*.ts" \
+  --exclude "**/*.test.ts"
+
+# Check for changes since last map
+python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py changes --root .
+
+# Sync hashes after manual map updates
+python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py update --root .
+```
+</details>
+
+### Skills Assignment
+
+You can customize which skills each agent is allowed to use in `~/.config/opencode/oh-my-opencode-slim.json`.
 
 **Syntax:**
 
 | Syntax | Description | Example |
 |--------|-------------|---------|
-| `"*"` | All skills | `["*"]` |
-| `"!item"` | Exclude specific skill | `["*", "!playwright"]` |
-| Explicit list | Only listed skills | `["simplify", "playwright"]` |
+| `"*"` | All installed skills | `["*"]` |
+| `"!item"` | Exclude specific skill | `["*", "!agent-browser"]` |
+| Explicit list | Only listed skills | `["simplify"]` |
 | `"!*"` | Deny all skills | `["!*"]` |
 
 **Rules:**
@@ -519,30 +726,16 @@ You can customize which skills each agent uses by editing your plugin configurat
   "presets": {
     "my-preset": {
       "orchestrator": {
-        "skills": ["*", "!playwright"]
+        "skills": ["*", "!agent-browser"]
       },
       "designer": {
-        "skills": ["playwright", "simplify"]
+        "skills": ["agent-browser", "simplify"]
       }
     }
   }
 }
 ```
 
-### Simplify
-
-**The Minimalist's sacred truth: every line of code is a liability.**
-
-Use after major refactors or before finalizing PRs. Identifies unnecessary complexity, challenges premature abstractions, estimates LOC reduction, and enforces minimalism.
-
-### Playwright Integration
-
-**Browser automation for visual verification and testing.**
-
-- **Browser Automation**: Full Playwright capabilities (browsing, clicking, typing, scraping).
-- **Screenshots**: Capture visual state of any web page.
-- **Sandboxed Output**: Screenshots saved to session subdirectory (check tool output for path).
-
 ---
 
 ## 🔌 MCP Servers
@@ -765,6 +958,13 @@ The installer generates this file based on your providers. You can manually cust
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
+| `preset` | string | - | Name of the preset to use (e.g., `"openai"`, `"cliproxy"`) |
+| `presets` | object | - | Named preset configurations containing agent mappings |
+| `presets.<name>.<agent>.model` | string | - | Model ID for the agent (e.g., `"google/claude-opus-4-5-thinking"`) |
+| `presets.<name>.<agent>.temperature` | number | - | Temperature setting (0-2) for the agent |
+| `presets.<name>.<agent>.variant` | string | - | Agent variant for reasoning effort (e.g., `"low"`, `"medium"`, `"high"`) |
+| `presets.<name>.<agent>.skills` | string[] | - | Array of skill names the agent can use (`"*"` for all, `"!item"` to exclude) |
+| `presets.<name>.<agent>.mcps` | string[] | - | Array of MCP names the agent can use (`"*"` for all, `"!item"` to exclude) |
 | `tmux.enabled` | boolean | `false` | Enable tmux pane spawning for sub-agents |
 | `tmux.layout` | string | `"main-vertical"` | Layout preset: `main-vertical`, `main-horizontal`, `tiled`, `even-horizontal`, `even-vertical` |
 | `tmux.main_pane_size` | number | `60` | Main pane size as percentage (20-80) |