diff --git a/README.md b/README.md
index ef98d955..d0081ff5 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,23 @@
-# SkillHub
+<div align="center">
+  <img src="./skillhub-logo.svg" alt="SkillHub Logo" width="120" height="120" />
+  <h1>SkillHub</h1>
+  <p>An enterprise-grade, open-source agent skill registry — publish, discover, and manage reusable skill packages across your organization.</p>
+</div>
 
-An enterprise-grade, open-source agent skill registry — publish, discover, and
-manage reusable skill packages across your organization.
+<div align="center">
+
+[![Docs](https://img.shields.io/badge/docs-zread.ai-4A90E2?logo=gitbook&logoColor=white)](https://zread.ai/iflytek/skillhub)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](./LICENSE)
+[![Build](https://github.com/iflytek/skillhub/actions/workflows/publish-images.yml/badge.svg)](https://github.com/iflytek/skillhub/actions/workflows/publish-images.yml)
+[![GitHub Stars](https://img.shields.io/github/stars/iflytek/skillhub?style=social)](https://github.com/iflytek/skillhub/stargazers)
+[![GitHub Forks](https://img.shields.io/github/forks/iflytek/skillhub?style=social)](https://github.com/iflytek/skillhub/network/members)
+[![Docker](https://img.shields.io/badge/docker-ghcr.io-2496ED?logo=docker&logoColor=white)](https://ghcr.io/iflytek/skillhub)
+[![Java](https://img.shields.io/badge/java-21-ED8B00?logo=openjdk&logoColor=white)](https://openjdk.org/projects/jdk/21/)
+[![React](https://img.shields.io/badge/react-19-61DAFB?logo=react&logoColor=black)](https://react.dev)
+
+</div>
+
+---
 
 SkillHub is a self-hosted platform that gives teams a private,
 governed place to share agent skills. Publish a skill package, push
@@ -9,6 +25,8 @@ it to a namespace, and let others find it through search or
 install it via CLI. Built for on-premise deployment behind your
 firewall, with the same polish you'd expect from a public registry.
 
+📖 **[Full Documentation →](https://zread.ai/iflytek/skillhub)**
+
 ## Highlights
 
 - **Self-Hosted & Private** — Deploy on your own infrastructure.
diff --git a/skillhub-logo.svg b/skillhub-logo.svg
new file mode 100644
index 00000000..1a9b3b62
--- /dev/null
+++ b/skillhub-logo.svg
@@ -0,0 +1 @@
+<svg width="512" height="512" viewBox="0 0 200 200" fill="none" xmlns="http://www.w3.org/2000/svg" data-fg-go4109="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:217:7:9326:2949:e:svg:etxtxtetxtetxtetxtetetxtetetetxtetetetxtetxtete" data-fgid-go4109=":r4k:"><defs data-fg-go4110="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:218:9:9436:254:e:defs:e"><linearGradient id="packageGradient" x1="0%" y1="0%" x2="100%" y2="100%" data-fg-go4111="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:219:11:9453:221:e:linearGradient:ete"><stop offset="0%" stop-color="#2563eb" data-fg-go4112="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:220:13:9539:45:e:stop"/><stop offset="100%" stop-color="#1e40af" data-fg-go4113="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:221:13:9597:49:e:stop"/></linearGradient></defs><path d="M 100 50 L 150 75 L 100 100 L 50 75 Z" fill="#3b82f6" stroke="#1e40af" stroke-width="2" data-fg-go4116="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:227:9:9775:157:e:path"/><path d="M 50 75 L 50 135 L 100 160 L 100 100 Z" fill="#2563eb" stroke="#1e40af" stroke-width="2" opacity="0.9" data-fg-go4118="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:235:9:9968:183:e:path"/><path d="M 100 100 L 100 160 L 150 135 L 150 75 Z" fill="#1e40af" stroke="#1e40af" stroke-width="2" data-fg-go4120="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:244:9:10188:163:e:path"/><path d="M 100 50 L 100 100" stroke="#eff6ff" stroke-width="4" opacity="0.6" data-fg-go4122="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:252:9:10397:129:e:path"/><path d="M 75 62.5 L 125 87.5" stroke="#eff6ff" stroke-width="4" opacity="0.6" data-fg-go4123="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:258:9:10535:131:e:path"/><rect x="60" y="100" width="30" height="12" rx="2" fill="#eff6ff" opacity="0.7" data-fg-go4125="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:266:9:10719:85:e:rect"/><line x1="63" y1="104" x2="87" y2="104" stroke="#1e40af" stroke-width="1.5" data-fg-go4126="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:267:9:10813:84:e:line"/><line x1="63" y1="108" x2="82" y2="108" stroke="#1e40af" stroke-width="1.5" data-fg-go4127="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:268:9:10906:84:e:line"/><circle cx="120" cy="100" r="6" fill="#eff6ff" opacity="0.5" data-fg-go4129="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:271:9:11042:66:e:circle"/><circle cx="120" cy="115" r="6" fill="#eff6ff" opacity="0.5" data-fg-go4130="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:272:9:11117:66:e:circle"/><circle cx="135" cy="107.5" r="6" fill="#eff6ff" opacity="0.5" data-fg-go4131="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:273:9:11192:68:e:circle"/><g opacity="0.7" data-fg-go4133="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:276:9:11335:668:e:g:etetetetete"><line x1="100" y1="50" x2="100" y2="30" stroke="#3b82f6" stroke-width="2" stroke-dasharray="4 2" data-fg-go4134="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:277:11:11363:101:e:line"/><circle cx="100" cy="25" r="5" fill="#2563eb" stroke="#3b82f6" stroke-width="2" data-fg-go4135="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:278:11:11475:90:e:circle"/><line x1="150" y1="75" x2="165" y2="65" stroke="#3b82f6" stroke-width="2" stroke-dasharray="4 2" data-fg-go4136="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:280:11:11577:101:e:line"/><circle cx="170" cy="60" r="5" fill="#2563eb" stroke="#3b82f6" stroke-width="2" data-fg-go4137="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:281:11:11689:90:e:circle"/><line x1="50" y1="75" x2="35" y2="65" stroke="#3b82f6" stroke-width="2" stroke-dasharray="4 2" data-fg-go4138="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:283:11:11791:99:e:line"/><circle cx="30" cy="60" r="5" fill="#2563eb" stroke="#3b82f6" stroke-width="2" data-fg-go4139="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:284:11:11901:89:e:circle"/></g><circle cx="135" cy="145" r="18" fill="#2563eb" stroke="#eff6ff" stroke-width="3" data-fg-go4141="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:288:9:12062:91:e:circle"/><text x="135" y="152" font-size="20" font-weight="bold" fill="#eff6ff" text-anchor="middle" data-fg-go4142="1.13:5.12063:/src/app/components/SkillHubLogo.tsx:289:9:12162:100:e:text:t">S</text></svg>
\ No newline at end of file