From ea8168f2905f2db944074a3016811116a0b1b052 Mon Sep 17 00:00:00 2001
From: dongmucat <1127093059@qq.com>
Date: Wed, 6 May 2026 17:45:53 +0800
Subject: [PATCH] docs(cli): beautify README with icons and improve registry
 documentation

---
 cli/README.md    | 64 ++++++++++++++++++++++++++++++++----------------
 cli/package.json |  2 +-
 2 files changed, 44 insertions(+), 22 deletions(-)

diff --git a/cli/README.md b/cli/README.md
index 41bd5676..277cc70e 100644
--- a/cli/README.md
+++ b/cli/README.md
@@ -4,13 +4,13 @@ Manage and install skills for AI coding agents.
 
 SkillHub is an enterprise-grade, self-hosted skill registry that enables teams to discover, share, and install reusable skills for AI coding agents like Claude Code. This CLI provides a seamless interface to interact with SkillHub registries.
 
-## Installation
+## 📦 Installation
 
 ```bash
 npm install -g @astron-team/skillhub
 ```
 
-## Quick Start
+## 🚀 Quick Start
 
 ### Using the default registry
 
@@ -31,28 +31,39 @@ skillhub list
 ### Using a custom registry
 
 ```bash
-# Login to a custom registry for a single command flow
+# Login to a custom registry
 skillhub login --registry https://skillhub.yourcompany.com
 
-# Search and install from the custom registry
-skillhub search react --registry https://skillhub.yourcompany.com
-skillhub install @yourorg/custom-skill --registry https://skillhub.yourcompany.com
+# After login, other commands will use the same registry
+skillhub search react
+skillhub install @yourorg/custom-skill
 ```
 
 You can also set a default custom registry in your shell:
 
+**🐧 Linux/macOS (Bash/Zsh):**
 ```bash
 export SKILLHUB_REGISTRY=https://skillhub.yourcompany.com
 ```
 
-## Commands
+**🪟 Windows (PowerShell):**
+```powershell
+$env:SKILLHUB_REGISTRY="https://skillhub.yourcompany.com"
+```
 
-### Authentication
+**🪟 Windows (CMD):**
+```cmd
+set SKILLHUB_REGISTRY=https://skillhub.yourcompany.com
+```
+
+## 📚 Commands
+
+### 🔐 Authentication
 
 - `skillhub login [--registry <url>]` - Authenticate with a SkillHub registry
 - `skillhub logout [--registry <url>]` - Remove stored credentials
 
-### Skill Management
+### 🎯 Skill Management
 
 - `skillhub search <query>` - Search for skills in the registry
 - `skillhub install <skill-name>` - Install a skill to ~/.claude/skills/
@@ -60,12 +71,12 @@ export SKILLHUB_REGISTRY=https://skillhub.yourcompany.com
 - `skillhub list` - List all installed skills
 - `skillhub info <skill-name>` - Show detailed information about a skill
 
-### Utilities
+### 🛠️ Utilities
 
 - `skillhub version` - Display CLI version
 - `skillhub help` - Show help information
 
-## Examples
+## 💡 Examples
 
 ### Search and install a skill
 
@@ -96,12 +107,12 @@ skillhub uninstall @astron-team/react-component-builder
 # Login to your private registry
 skillhub login --registry https://skillhub.yourcompany.com
 
-# Search and install from your private registry
-skillhub search internal-tools --registry https://skillhub.yourcompany.com
-skillhub install @yourorg/internal-skill --registry https://skillhub.yourcompany.com
+# After login, search and install work automatically
+skillhub search internal-tools
+skillhub install @yourorg/internal-skill
 ```
 
-## Registry
+## 🌐 Registry
 
 ### Default registry
 
@@ -109,18 +120,29 @@ By default, the CLI connects to the public SkillHub registry at `https://skill.x
 
 ### Custom registry
 
-Organizations can deploy their own private SkillHub instance. You can point the CLI to a custom registry in either of these ways:
+Organizations can deploy their own private SkillHub instance. You can point the CLI to a custom registry:
 
+**Per-command (recommended for one-time use):**
 ```bash
-# Per-command override
 skillhub login --registry https://skillhub.yourcompany.com
-skillhub search react --registry https://skillhub.yourcompany.com
+```
 
-# Shell-level default
+**Shell-level default (persistent across commands):**
+
+🐧 Linux/macOS:
+```bash
 export SKILLHUB_REGISTRY=https://skillhub.yourcompany.com
 ```
 
-Use `--registry` when you want to target a specific registry for one command without changing your shell environment.
+🪟 Windows PowerShell:
+```powershell
+$env:SKILLHUB_REGISTRY="https://skillhub.yourcompany.com"
+```
+
+🪟 Windows CMD:
+```cmd
+set SKILLHUB_REGISTRY=https://skillhub.yourcompany.com
+```
 
 ### Skill namespaces
 
@@ -131,7 +153,7 @@ Skills are namespaced by organization to prevent naming conflicts:
 
 When installing skills, always include the full namespaced name.
 
-## License
+## 📄 License
 
 Apache-2.0
 
diff --git a/cli/package.json b/cli/package.json
index a21ce6c6..61fdd205 100644
--- a/cli/package.json
+++ b/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@astron-team/skillhub",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Manage and install skills for AI coding agents",
   "keywords": [
     "skillhub",