Rewrite INSTALL.md for native skill discovery

Two-step install: clone + run installer. Replaces the old manual
setup that required editing AGENTS.md by hand.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.codex/INSTALL.md

@@ -1,35 +1,39 @@
 # Installing Superpowers for Codex
 
-Quick setup to enable superpowers skills in Codex.
+Quick setup to enable superpowers skills in Codex via native skill discovery.
 
 ## Installation
 
 1. **Clone superpowers repository**:
    ```bash
-   mkdir -p ~/.codex/superpowers
-   cd ~/.codex/superpowers
-   git clone https://github.com/obra/superpowers.git .
+   git clone https://github.com/obra/superpowers.git ~/.codex/superpowers
    ```
 
-2. **Create personal skills directory**:
+2. **Run the installer**:
    ```bash
-   mkdir -p ~/.codex/skills
+   node ~/.codex/superpowers/.codex/install-codex.mjs
    ```
 
-3. **Update ~/.codex/AGENTS.md** to include this superpowers section:
-   ```markdown
-   ## Superpowers System
+3. **Restart Codex** to discover the skills.
 
-   <EXTREMELY_IMPORTANT>
-   You have superpowers. Superpowers teach you new skills and capabilities. RIGHT NOW run: `node $HOME/.codex/superpowers/.codex/superpowers-codex bootstrap` and follow the instructions it returns.
-   </EXTREMELY_IMPORTANT>
-   ```
+## What the installer does
+
+- Creates a symlink: `~/.agents/skills/superpowers` → `~/.codex/superpowers/skills`
+- Adds a small gatekeeper block to `~/.codex/AGENTS.md`
+- If you had the old bootstrap setup, it removes it automatically
+
+## Updating
+
+```bash
+cd ~/.codex/superpowers && git pull
+```
+
+Skills update instantly through the symlink.
 
-## Verification
+## Uninstalling
 
-Test the installation:
 ```bash
-node $HOME/.codex/superpowers/.codex/superpowers-codex bootstrap
+rm ~/.agents/skills/superpowers
 ```
 
-You should see skill listings and bootstrap instructions. The system is now ready for use.
+Then remove the block between `<!-- superpowers:begin -->` and `<!-- superpowers:end -->` from `~/.codex/AGENTS.md`.