diff --git a/docs/tools/clawdhub.md b/docs/tools/clawdhub.md
index ecdef7a9c..298db66ec 100644
--- a/docs/tools/clawdhub.md
+++ b/docs/tools/clawdhub.md
@@ -50,7 +50,8 @@ bun add -g clawdhub
 
 By default, the CLI installs skills into `./skills` under your current working directory. Clawdbot loads workspace skills from `<workspace>/skills` and will pick them up in the **next** session. If you already use `~/.clawdbot/skills` or bundled skills, workspace skills take precedence.
 
-For more detail on how skills are loaded and gated, see `docs/skills.md`.
+For more detail on how skills are loaded, shared, and gated, see
+[Skills](/tools/skills).
 
 ## What the service provides (features)
 
diff --git a/docs/tools/skills.md b/docs/tools/skills.md
index a5ab6ccef..4d6e04654 100644
--- a/docs/tools/skills.md
+++ b/docs/tools/skills.md
@@ -36,6 +36,23 @@ In **multi-agent** setups, each agent has its own workspace. That means:
 If the same skill name exists in more than one place, the usual precedence
 applies: workspace wins, then managed/local, then bundled.
 
+## ClawdHub (install + sync)
+
+ClawdHub is the public skills registry for Clawdbot. Use it to discover,
+install, update, and back up skills. Full guide: [ClawdHub](/tools/clawdhub).
+
+Common flows:
+
+- Install a skill into your workspace:
+  - `clawdhub install <skill-slug>`
+- Update all installed skills:
+  - `clawdhub update --all`
+- Sync (scan + publish updates):
+  - `clawdhub sync --all`
+
+By default, `clawdhub` installs into `./skills` under your current working
+directory; Clawdbot picks that up as `<workspace>/skills` on the next session.
+
 ## Format (AgentSkills + Pi-compatible)
 
 `SKILL.md` must include at least: