diff --git a/README.md b/README.md
index 914b894..b8e77b5 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,88 @@
 # openclaw-auto-continue
 
-Reusable OpenClaw skill for /auto-continue (/ac) session-level auto-followup.
\ No newline at end of file
+Reusable OpenClaw skill for `/auto-continue` (`/ac`) session-level auto-followup.
+
+## What this repo contains
+
+- `openclaw-auto-continue/SKILL.md` — the **agent-facing** skill instructions
+- `openclaw-auto-continue.skill` — packaged skill artifact
+
+## For humans: how to use on another computer
+
+### Option 1: clone the repo
+
+```bash
+git clone https://gitea.cowbay.org/openclaw/openclaw-auto-continue.git
+cd openclaw-auto-continue
+```
+
+Then copy the skill folder into the target machine's OpenClaw skills directory:
+
+```bash
+mkdir -p ~/.openclaw/workspace/skills
+cp -R openclaw-auto-continue ~/.openclaw/workspace/skills/
+```
+
+### Option 2: use the packaged `.skill` file
+
+If your target OpenClaw environment already has a skill import/install flow, use:
+
+- `openclaw-auto-continue.skill`
+
+## On the target OpenClaw chat/session
+
+Installing the skill does **not** automatically enable auto-continue for every chat.
+You still need to turn it on in the specific chat/session where you want it active:
+
+```text
+/ac on
+```
+
+Check status:
+
+```text
+/ac status
+```
+
+Turn it off:
+
+```text
+/ac off
+```
+
+## What changes after `/ac on`
+
+When enabled, the current session uses followup-style continuation behavior:
+
+- `queueMode = "followup"`
+- `queueDebounceMs = 0`
+- `queueCap = 1`
+- `queueDrop = "summarize"`
+
+Practical effect:
+- the agent is more likely to continue into the next low-risk step
+- the agent is less likely to stop after every intermediate update
+- this is good for multi-step execution in the same chat
+
+## Important boundary
+
+This is **session-scoped**, not global.
+If you want it active in a different chat, enable it in that chat too.
+
+It also does **not** bypass:
+- approvals
+- safety checks
+- destructive action confirmation
+- user decision points
+
+## For agents
+
+If an OpenClaw agent is deciding how to use this repo:
+
+1. Read `openclaw-auto-continue/SKILL.md`
+2. Follow the trigger conditions and command usage there
+3. Use `/ac on`, `/ac off`, and `/ac status` in the relevant chat/session
+
+In short:
+- `README.md` is the human/operator guide
+- `openclaw-auto-continue/SKILL.md` is the agent-facing guide