diff --git a/openclaw/README.md b/openclaw/README.md
index b20d86d06..be9f53844 100644
--- a/openclaw/README.md
+++ b/openclaw/README.md
@@ -1,6 +1,6 @@
 # OpenClaw compatibility
 
-This subtree contains OpenClaw-native adaptations of selected gstack workflows.
+This subtree contains OpenClaw-native adaptations of selected gstack workflows. It is meant to be understandable and usable by OpenClaw agents without requiring Claude-specific hooks or generated preambles.
 
 Goals:
 - preserve the role/workflow value of gstack
@@ -22,3 +22,6 @@ Suggested mapping:
 Ported skill set currently includes review, investigation, office-hours/product planning, QA, design review/consultation, ship + deploy flows, post-ship docs, canary checks, safety modes, security review, retrospective, authenticated browser setup, and delegated coding-agent consultation.
 
 See `openclaw/references/gstack-port-notes.md` for the main runtime translation choices and limitations.
+
+
+See `openclaw/references/skill-index.md` for a quick index of the ported skills.
diff --git a/openclaw/references/gstack-port-notes.md b/openclaw/references/gstack-port-notes.md
index a0d58b32c..236e9605d 100644
--- a/openclaw/references/gstack-port-notes.md
+++ b/openclaw/references/gstack-port-notes.md
@@ -31,3 +31,11 @@ This compatibility subtree keeps the spirit of selected gstack skills while adap
 
 - gstack's `codex` idea maps best to delegating with the `coding-agent` skill in OpenClaw.
 - Use a read-only independent pass by default unless the user explicitly asks for fixes.
+
+
+## Gaps and follow-ups
+
+- The safety-mode ports are advisory rather than hook-enforced.
+- Browser-heavy skills depend on OpenClaw browser availability and sometimes user presence for auth.
+- The compatibility subtree does not yet integrate with gstack's template generator, so OpenClaw variants are maintained separately for now.
+- The quality of these ports comes from concise workflow transfer, not 1:1 feature parity.
diff --git a/openclaw/references/skill-index.md b/openclaw/references/skill-index.md
new file mode 100644
index 000000000..a15b094c3
--- /dev/null
+++ b/openclaw/references/skill-index.md
@@ -0,0 +1,41 @@
+# OpenClaw ported skill index
+
+## Product / planning
+- `gstack-office-hours` — YC-style startup and product diagnostic
+- `gstack-plan-ceo-review` — product/narrative review
+- `gstack-plan-eng-review` — engineering plan review
+
+## Review / debugging / security
+- `gstack-review` — pre-ship review
+- `gstack-investigate` — root-cause debugging
+- `gstack-cso` — security review
+- `gstack-codex` — independent coding-agent second opinion
+
+## QA / design
+- `gstack-qa` — test, fix, re-verify
+- `gstack-qa-only` — report-only QA
+- `gstack-design-review` — visual/interaction audit
+- `gstack-design-consultation` — design direction and system planning
+- `gstack-setup-browser-cookies` — authenticated browser setup guidance
+
+## Shipping / deploy / docs
+- `gstack-ship` — pre-merge branch hardening
+- `gstack-land-and-deploy` — merge + deploy + verify
+- `gstack-canary` — immediate post-deploy smoke verification
+- `gstack-setup-deploy` — discover and document deploy context
+- `gstack-document-release` — update docs after shipping
+
+## Safety / scope control
+- `gstack-careful` — caution before destructive actions
+- `gstack-freeze` — restrict edits to a declared area
+- `gstack-guard` — combine careful + freeze
+- `gstack-unfreeze` — remove or widen the declared boundary
+
+## Reflection
+- `gstack-retro` — retrospective over a sprint/release/work window
+
+## What remains intentionally incomplete
+These ports preserve role and workflow value, not full runtime parity with Claude Code. In particular:
+- no Claude hook enforcement for safety modes
+- no generated-skill pipeline for OpenClaw variants yet
+- no automatic cookie import or gstack browse daemon parity