fix: correct Codex install paths and add commands reference

- Fix prompts path: ~/.codex/prompts/ (was ~/.agents/commands/)
- Add Available Commands section to SKILL.md for discoverability
- Document invocation patterns for Pi, Claude Code, and Codex
- Bump SKILL.md version to 0.5.1
- Fix misleading file tree arrow in README

Author: nicobailon

CHANGELOG.md

@@ -14,6 +14,11 @@
 - Pi users now clone repo and copy skill + prompts to `~/.pi/agent/skills/` and `~/.pi/agent/prompts/`
 - Removed stale `pi` field from `package.json` (was pointing to non-existent root paths)
 
+### OpenAI Codex Install Fix
+- Fixed prompts path: `~/.codex/prompts/` (was incorrectly `~/.agents/commands/`)
+- Prompts are optional (deprecated feature) — skill works without them via `$visual-explainer`
+- With prompts installed, invoke as `/prompts:diff-review`, `/prompts:plan-review`, etc.
+
 ### Breaking Changes
 - Direct Claude Code plugin install (`/plugin install https://...`) no longer works — use marketplace flow instead
 - `pi install https://github.com/nicobailon/visual-explainer` no longer works — use manual install

README.md

@@ -54,12 +54,19 @@ rm -rf /tmp/visual-explainer
 **OpenAI Codex:**
 ```bash
 git clone --depth 1 https://github.com/nicobailon/visual-explainer.git /tmp/visual-explainer
+
+# Install skill
 cp -r /tmp/visual-explainer/plugins/visual-explainer ~/.agents/skills/visual-explainer
-mkdir -p ~/.agents/commands
-cp /tmp/visual-explainer/plugins/visual-explainer/commands/*.md ~/.agents/commands/
+
+# Optional: Install slash commands (deprecated, but works)
+mkdir -p ~/.codex/prompts
+cp /tmp/visual-explainer/plugins/visual-explainer/commands/*.md ~/.codex/prompts/
+
 rm -rf /tmp/visual-explainer
 ```
 
+Invoke with `$visual-explainer` or let Codex activate it implicitly. With prompts installed, use `/prompts:diff-review`, `/prompts:plan-review`, etc.
+
 ## Commands
 
 | Command | What it does |
@@ -109,11 +116,11 @@ plugins/
     │   ├── data-table.html
     │   └── slide-deck.html
     └── scripts/
-        └── share.sh
-            ↓
-~/.agent/diagrams/filename.html → opens in browser
+        └── share.sh       ← deploy HTML to Vercel for sharing
 ```
 
+**Output:** `~/.agent/diagrams/filename.html` → opens in browser
+
 The skill routes to the right approach automatically: Mermaid for flowcharts and diagrams, CSS Grid for architecture overviews, HTML tables for data, Chart.js for dashboards.
 
 ## Limitations

plugins/visual-explainer/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: Requires a browser to view generated HTML files. Optional surf-cli for AI image generation.
 metadata:
   author: nicobailon
-  version: "0.5.0"
+  version: "0.5.1"
 ---
 
 # Visual Explainer
@@ -14,6 +14,21 @@ Generate self-contained HTML files for technical diagrams, visualizations, and d
 
 **Proactive table rendering.** When you're about to present tabular data as an ASCII box-drawing table in the terminal (comparisons, audits, feature matrices, status reports, any structured rows/columns), generate an HTML page instead. The threshold: if the table has 4+ rows or 3+ columns, it belongs in the browser. Don't wait for the user to ask — render it as HTML automatically and tell them the file path. You can still include a brief text summary in the chat, but the table itself should be the HTML page.
 
+## Available Commands
+
+Detailed prompt templates in `./commands/`. In Pi, these are slash commands (`/diff-review`). In Claude Code, namespaced (`/visual-explainer:diff-review`). In Codex, use `/prompts:diff-review` (if installed to `~/.codex/prompts/`) or invoke `$visual-explainer` and describe the workflow.
+
+| Command | What it does |
+|---------|-------------|
+| `generate-web-diagram` | Generate an HTML diagram for any topic |
+| `generate-visual-plan` | Generate a visual implementation plan for a feature |
+| `generate-slides` | Generate a magazine-quality slide deck |
+| `diff-review` | Visual diff review with architecture comparison and code review |
+| `plan-review` | Compare a plan against the codebase with risk assessment |
+| `project-recap` | Mental model snapshot for context-switching back to a project |
+| `fact-check` | Verify accuracy of a document against actual code |
+| `share` | Deploy an HTML page to Vercel and get a live URL |
+
 ## Workflow
 
 ### 1. Think (5 seconds, not 5 minutes)