docs: normalize documentation, rename to EMP Skills and setup skills hub

Author: xuhongbin

DOCUMENTATION_INDEX.md

@@ -33,7 +33,7 @@ emp-skill/
 │   │   ├── IMPLEMENTATION.md   # 实现指南
 │   │   └── PROJECT_SUMMARY.md  # 项目总结
 │   └── website/                 # 📄 静态网站
-├── skill-recomend.md            # 💡 技能推荐文档
+├── SKILL_RECOMMENDATION.md            # 💡 技能推荐文档
 ├── DOCUMENTATION_INDEX.md       # 🗂️ 文档索引
 ├── README.md                    # 🏠 项目总览
 ├── package.json
@@ -65,7 +65,7 @@ emp-skill/
 |------|------|------|
 | 实现指南 | [apps/web/IMPLEMENTATION.md](./apps/web/IMPLEMENTATION.md) | 详细实现步骤 |
 | 项目总结 | [apps/web/PROJECT_SUMMARY.md](./apps/web/PROJECT_SUMMARY.md) | 项目架构总结 |
-| 技能推荐 | [skill-recomend.md](./skill-recomend.md) | 技能推荐文档 |
+| 技能推荐 | [SKILL_RECOMMENDATION.md](./SKILL_RECOMMENDATION.md) | 技能推荐文档 |
 
 ## 🎯 按用户角色查找文档
 
@@ -151,19 +151,19 @@ Web 浏览 → Web 平台 (docs/WEB_PLATFORM.md)
 ## 🤝 反馈渠道
 
 ### 文档问题
-- **GitHub Issues**: https://github.com/emp/skill/issues
+- **GitHub Issues**: https://github.com/empjs/skill/issues
 - **标签**: `documentation`
 
 ### 改进建议
-- **GitHub Discussions**: https://github.com/emp/skill/discussions
+- **GitHub Discussions**: https://github.com/empjs/skill/discussions
 - **分类**: `Documentation`
 
 ## 📞 联系我们
 
-- **项目主页**: https://emp-skill.com
-- **GitHub 仓库**: https://github.com/emp/skill
+- **项目主页**: https://skill.empjs.dev
+- **GitHub 仓库**: https://github.com/empjs/skill
 - **Discord 社区**: https://discord.gg/emp-skill
-- **邮箱**: team@emp-skill.com
+- **邮箱**: team@skill.empjs.dev
 
 ---
 

README.md

@@ -0,0 +1,91 @@
+# @empjs/skill - Unified AI Agent Skill Hub
+
+[![NPM Version](https://img.shields.io/npm/v/@empjs/skill.svg)](https://www.npmjs.com/package/@empjs/skill)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+The Enterprise Distribution Hub for AI Agent Skills. Securely bridge your internal engineering standards with AI Agents (Claude, Cursor, Windsurf, and more).
+
+## 🚀 Overview
+
+`@empjs/skill` is a unified CLI tool and platform designed to manage, distribute, and trace AI agent skills across multiple platforms. It solves the fragmentation of skill management by providing a centralized hub for all your agent extensions.
+
+- **Unified Registry**: Centralized skill management in `~/.emp-agent/skills/`.
+- **18+ Agents Supported**: Auto-detects and links to Claude Code, Cursor, Windsurf, Trae, Gemini, and more.
+- **Smart Distribution**: Zero manual path configuration.
+- **Private Repo Support**: Seamless integration with private GitLab/GitHub repositories.
+- **B2B On-demand**: Monorepo support for project-specific skill installation.
+
+## 📦 Supported AI Agents
+
+The platform automatically detects and supports:
+
+- **Claude Code** (`~/.claude/skills/`)
+- **Cursor** (`~/.cursor/skills/`)
+- **Windsurf** (`~/.windsurf/skills/`)
+- **Trae** (`~/.trae/skills/`)
+- **Gemini** (`~/.gemini/skills/`)
+- **Cline**, **Roo Code**, **Goose**, **AMP**, and many more.
+
+## 🛠️ Installation
+
+```bash
+# Using pnpm (recommended)
+pnpm add -g @empjs/skill
+
+# Using npm
+npm install -g @empjs/skill
+```
+
+## 📖 Quick Start
+
+### Install a Skill
+```bash
+# Install from NPM
+eskill install @empjs/skill-example
+
+# Install from Git URL (GitHub/GitLab)
+eskill install https://github.com/empjs/skill/tree/main/packages/yapi-mock-data
+```
+
+### List Skills
+```bash
+eskill list
+```
+
+### Dev Mode
+```bash
+cd path/to/your-skill
+eskill install . --link
+```
+
+## 📁 Project Structure
+
+- `apps/website`: The official website (built with Vite + Tailwind).
+- `packages/eskill`: The core CLI tool.
+- `packages/yapi-mock-data`: An example skill package.
+- `docs/`: Comprehensive documentation.
+- `skills/`: Skill definitions and templates.
+
+## 📚 Documentation
+
+For more detailed information, please refer to our documentation:
+
+- [Documentation Index](./DOCUMENTATION_INDEX.md)
+- [CLI Guide](./docs/CLI_GUIDE.md)
+- [Architecture](./docs/ARCHITECTURE.md)
+- [Web Platform](./docs/WEB_PLATFORM.md)
+- [Deployment](./docs/DEPLOYMENT.md)
+- [Contribution Guide](./docs/CONTRIBUTION.md)
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](./docs/CONTRIBUTION.md) for more details.
+
+## 📄 License
+
+© 2026 EMP Team. Licensed under the [MIT License](./LICENSE).
+
+## 🔗 Links
+
+- **Repository**: [https://github.com/empjs/skill](https://github.com/empjs/skill)
+- **Website**: [https://skill.empjs.dev](https://skill.empjs.dev) (Hosted on Cloudflare)

SKILL.md

@@ -0,0 +1,52 @@
+# 🚀 AI Agent Skills Guide
+
+This project provides a unified hub for managing AI Agent skills. Skills are stored in the `skills/` directory and can be installed via the `eskill` CLI.
+
+## 📂 Skill Directory Structure
+
+Skills should be organized within the `skills/` folder:
+
+```
+skills/
+├── your-skill-name/
+│   ├── SKILL.md          # Core skill definition
+│   └── ...               # Supporting files
+└── TEMPLATE.md           # Template for new skills
+```
+
+## 📝 Defining a Skill
+
+A skill is defined by a `SKILL.md` file with frontmatter metadata:
+
+```markdown
+---
+name: my-awesome-skill
+description: "Does something amazing"
+version: "1.0.0"
+---
+
+# My Awesome Skill
+
+Detailed instructions for the AI Agent...
+```
+
+## 🛠️ Usage
+
+To install a skill locally for development:
+
+```bash
+eskill install ./skills/your-skill-name --link
+```
+
+To install a skill from the repository:
+
+```bash
+eskill install https://github.com/empjs/skill/tree/main/skills/your-skill-name
+```
+
+## 🌟 Best Practices
+
+- Keep skill definitions focused and concise.
+- Provide clear examples of how the agent should use the skill.
+- Use versioning to manage changes.
+- Test your skills across multiple agents (Claude, Cursor, Windsurf, etc.).