docs(guides): make standalone installer guide more user-friendly

README.md

@@ -30,17 +30,7 @@ installation, use the guides below. Pick your agent:
 - **[Droid](guides/droid.md)**
 - **[Gemini CLI](guides/gemini-cli.md)**
 - **[Anything else (standalone installer)](guides/generic.md)** — works in any
-  agent with a shell (and for humans at a terminal):
-
-  ```bash
-  curl -fsSL https://zero.xyz/install.sh | bash
-  ```
-
-  It provisions the same runner the plugins use, puts `zero` on PATH, and
-  installs the Zero skill where most harnesses look (`~/.claude/skills/` and
-  `~/.agents/skills/`). The whole install is reversible with `zero uninstall`.
-  See the [standalone install guide](guides/generic.md) for what gets installed
-  where, the `--skills-dir` flag for bespoke skill directories, and updates.
+  agent with a shell (and for humans at a terminal)
 
 Once installed, ask your agent to *"help me set up and test Zero"* — it signs
 you in and takes it from there.

guides/generic.md

@@ -1,74 +1,52 @@
 # Zero for any agent (standalone installer)
 
-How to install Zero in any agent or harness with a shell — and for humans at a
-terminal — using the standalone installer, then keep it up to date.
-
-Use this when there's no dedicated plugin for your harness (Claude Code, Codex,
-Droid, and Gemini CLI have their own guides — prefer those). The installer
-provisions the **same** runner the plugins use, so you end up in the same place.
+How to install Zero in any agent or harness with a shell. Use this when there's
+no dedicated guide for your agent.
 
 ## Install
 
+Run this in your terminal:
+
 ```bash
 curl -fsSL https://zero.xyz/install.sh | bash
 ```
 
-That single command:
-
-- provisions the Zero runner (downloading a `node` binary if one isn't found)
-  and puts `zero` on your `PATH`,
-- runs `zero init`, which installs the **Zero skill** and registers the **Zero
-  hooks** (see [What gets installed where](#what-gets-installed-where) below).
+That's it — Zero sets itself up automatically and works across all your agents.
+You only need to do this once per machine.
 
-Once it finishes, ask your agent: *"Help me set up and test Zero."* It walks
-you through signing in (you approve a browser sign-in once per machine).
+When it finishes, ask your agent: *"Help me set up and test Zero."* It walks you
+through signing in (a quick browser sign-in, once per machine).
 
-## What gets installed where
+### Using an agent with its own skills folder?
 
-`zero init` writes to the directories nearly every skills-capable harness reads:
+The installer already covers nearly every agent. If yours keeps skills in its
+own folder and didn't pick Zero up, point the installer at that folder:
 
-- **The Zero skill** → `~/.claude/skills/zero/` **and** `~/.agents/skills/zero/`.
-  Between those two locations, almost every harness picks up the skill from one
-  or the other.
-- **The Zero hooks** → `~/.claude/settings.json`, for Claude-compatible hosts.
-  These keep the runner provisioned and up to date and remind the agent that
-  Zero is available.
-
-All hosts share one login (`~/.zero/config.json`) and one runtime
-(`~/.zero/runtime`), so you only sign in once per machine.
+```bash
+zero init --skills-dir ~/.youragent/skills
+```
 
-### Harnesses with a bespoke skills directory
+## Staying up to date
 
-`~/.claude/skills` and `~/.agents/skills` are **always** written. If your
-harness reads skills from its own directory in addition to those (say
-`~/.yourharness/skills`), name it with `--skills-dir` to install the skill there
-too — the flag is additive, and accepts more than one directory:
+To update, just re-run the install command:
 
 ```bash
-zero init --skills-dir ~/.yourharness/skills
-# or several at once:
-zero init --skills-dir ~/.kiro/skills ~/.other/skills
+curl -fsSL https://zero.xyz/install.sh | bash
 ```
 
-`zero init` is idempotent, so re-running it replaces rather than duplicates.
-Note that `zero uninstall` only cleans the default locations — skills written to
-a custom `--skills-dir` you remove by hand.
-
-## Staying up to date
-
-- The Zero runner updates automatically at the start of each session.
-- To refresh the skill and hooks, re-run `zero init`.
+If Zero is already installed, it simply updates in place. Safe to run as often
+as you like.
 
 ## Uninstalling
 
-The whole install is reversible:
+Changed your mind? Remove Zero completely:
 
 ```bash
 zero uninstall
 ```
 
 ---
 
-Installing Zero for a coding agent yourself? The full agent-facing runbook —
-including authentication and per-harness plugin install — is in
+Setting Zero up for a coding agent and want the full technical details — what
+gets installed where, authentication, and per-agent plugins? See
 [agent-install.md](agent-install.md).