diff --git a/overview/skills.mdx b/overview/skills.mdx
index 8fe46843..1ce06328 100644
--- a/overview/skills.mdx
+++ b/overview/skills.mdx
@@ -51,7 +51,7 @@ Each skill file may include frontmatter that provides additional information. In
 
 | Platform | Support Level | Configuration Method | Implementation | Documentation |
 |----------|---------------|---------------------|----------------|---------------|
-| **CLI** | ✅ Full Support | `.openhands/skills/` directory | File-based markdown | This guide |
+| **CLI** | ✅ Full Support | `~/.openhands/skills/` (user-level) and `.openhands/skills/` (repo-level) | File-based markdown | [CLI Settings](/openhands/usage/run-openhands/cli-settings#skills-configuration) |
 | **SDK** | ✅ Full Support | Programmatic `Skill` objects | Code-based configuration | [SDK Skills Guide](/sdk/guides/skill) |
 | **Local GUI** | ✅ Full Support | `.openhands/skills/` + UI | File-based with UI management | [Local Setup](/openhands/usage/run-openhands/local-setup) |
 | **OpenHands Cloud** | ✅ Full Support | Cloud UI + repository integration | Managed skill library | [Cloud UI](/openhands/usage/cloud/cloud-ui) |
@@ -60,10 +60,13 @@ Each skill file may include frontmatter that provides additional information. In
 
 <Tabs>
   <Tab title="CLI">
-    - File-based configuration in `.openhands/skills/` directory
+    - File-based configuration in two locations:
+      - `~/.openhands/skills/` - User-level skills (all conversations)
+      - `.openhands/skills/` - Repository-level skills (current directory)
     - Markdown format for skill definitions
     - Manual file management required
     - Supports both general and keyword-triggered skills
+    - See [CLI Skills Configuration](/openhands/usage/run-openhands/cli-settings#skills-configuration) for details
   </Tab>
   <Tab title="SDK">
     - Programmatic `Skill` objects in code