docs: add skills.sh install guidance

Author: linhay

README.md

@@ -5,6 +5,7 @@
 语言：中文 | [English](./README_en.md)
 
 [![release](https://img.shields.io/badge/release-v1.3.23-1f6feb?style=flat-square)](https://github.com/linhay/harmony-next.skills/releases/tag/v1.3.23)
+[![skills.sh](https://skills.sh/b/linhay/harmony-next.skills)](https://skills.sh/linhay/harmony-next.skills)
 [![readme](https://img.shields.io/badge/readme-English-0f766e?style=flat-square)](./README_en.md)
 ![docs](https://img.shields.io/badge/docs-3,693%20markdown%20files-7c3aed?style=flat-square)
 ![js-ets](https://img.shields.io/badge/JsEtsAPIReference-3,666%20files-b45309?style=flat-square)
@@ -144,6 +145,32 @@ SKILL.md
 
 ## 快速接入
 
+### Vercel Labs skills CLI（推荐通用方式）
+
+本仓库可被 [`vercel-labs/skills`](https://github.com/vercel-labs/skills) 直接发现并安装：
+
+```bash
+npx skills add linhay/harmony-next.skills --skill harmony-next
+```
+
+只查看可用技能：
+
+```bash
+npx skills add linhay/harmony-next.skills --list
+```
+
+安装到 Codex 的全局技能目录（非交互，复制文件而不是软链）：
+
+```bash
+npx skills add linhay/harmony-next.skills --skill harmony-next -a codex -g -y --copy
+```
+
+相关目录与官方示例仓库：
+
+- [`skills.sh`](https://skills.sh/)：`vercel-labs/skills` 使用的公开目录与安全评分入口；本仓库页面是 [`skills.sh/linhay/harmony-next.skills`](https://skills.sh/linhay/harmony-next.skills)。
+- [`vercel-labs/agent-skills`](https://github.com/vercel-labs/agent-skills)：Vercel 官方维护的 Agent Skills 集合。
+- [`anthropics/skills`](https://github.com/anthropics/skills)：Anthropic 的公开 Agent Skills 仓库，包含 Claude skills 示例、规范与模板。
+
 ### Gemini CLI
 
 ```bash
@@ -152,10 +179,15 @@ gemini skills install https://github.com/linhay/harmony-next.skills --path harmo
 
 ### Claude Code
 
-1. 下载本仓库中的技能目录。
-2. 按需压缩技能文件夹。
-3. 在 Claude.ai 的 `Settings > Capabilities > Skills` 中上传。
-4. 或直接放进你的 Claude Code 技能目录。
+推荐使用 `vercel-labs/skills` CLI 安装到 Claude Code：
+
+```bash
+npx skills add linhay/harmony-next.skills --skill harmony-next -a claude-code -g -y --copy
+```
+
+这会把技能安装到 Claude Code 的全局技能目录（当前 CLI 行为是 `~/.claude/skills/harmony-next`）。
+
+Claude.ai 网页端仍可使用 release 中的 `harmony-next.skill.zip`：在 `Settings > Capabilities > Skills` 中上传。
 
 如果你只是想把仓库作为项目上下文附加：
 
@@ -166,11 +198,17 @@ claude --add-dir /path/to/harmony-next.skills/harmony-next
 
 ### Codex
 
+推荐使用 `vercel-labs/skills` CLI 安装到 Codex：
+
+```bash
+npx skills add linhay/harmony-next.skills --skill harmony-next -a codex -g -y --copy
+```
+
 官方 Codex Agent Skills 文档说明：skill 是可复用工作流的创作格式；直接 skill 目录用于本地创作与发现；可安装分发单元是 Codex plugin。
 
 官方文档：<https://developers.openai.com/codex/skills>
 
-本仓库当前还没有打包成 Codex plugin，因此 Codex 的官方接入方式是放入官方 skill 扫描路径。
+本仓库当前还没有打包成 Codex plugin。如果不使用 `npx skills`，可手动放入官方 skill 扫描路径。
 
 可选官方路径：
 

README_en.md

@@ -5,6 +5,7 @@ An offline HarmonyOS NEXT reference skill for coding agents such as Gemini CLI,
 Language: English | [中文](./README.md)
 
 [![release](https://img.shields.io/badge/release-v1.3.23-1f6feb?style=flat-square)](https://github.com/linhay/harmony-next.skills/releases/tag/v1.3.23)
+[![skills.sh](https://skills.sh/b/linhay/harmony-next.skills)](https://skills.sh/linhay/harmony-next.skills)
 [![readme](https://img.shields.io/badge/readme-%E4%B8%AD%E6%96%87-0f766e?style=flat-square)](./README.md)
 ![docs](https://img.shields.io/badge/docs-3,693%20markdown%20files-7c3aed?style=flat-square)
 ![js-ets](https://img.shields.io/badge/JsEtsAPIReference-3,666%20files-b45309?style=flat-square)
@@ -144,6 +145,32 @@ Usage rules:
 
 ## Quick Start
 
+### Vercel Labs skills CLI (recommended generic path)
+
+This repository can be discovered and installed directly by [`vercel-labs/skills`](https://github.com/vercel-labs/skills):
+
+```bash
+npx skills add linhay/harmony-next.skills --skill harmony-next
+```
+
+List available skills without installing:
+
+```bash
+npx skills add linhay/harmony-next.skills --list
+```
+
+Install globally for Codex non-interactively, copying files instead of symlinking:
+
+```bash
+npx skills add linhay/harmony-next.skills --skill harmony-next -a codex -g -y --copy
+```
+
+Related directories and official example repositories:
+
+- [`skills.sh`](https://skills.sh/): the public directory and security-assessment entry used by `vercel-labs/skills`; this repository's page is [`skills.sh/linhay/harmony-next.skills`](https://skills.sh/linhay/harmony-next.skills).
+- [`vercel-labs/agent-skills`](https://github.com/vercel-labs/agent-skills): Vercel's official Agent Skills collection.
+- [`anthropics/skills`](https://github.com/anthropics/skills): Anthropic's public Agent Skills repository, including Claude skill examples, the spec, and a template.
+
 ### Gemini CLI
 
 ```bash
@@ -152,10 +179,15 @@ gemini skills install https://github.com/linhay/harmony-next.skills --path harmo
 
 ### Claude Code
 
-1. Download the skill directory from this repository.
-2. Zip it if needed.
-3. Upload it in Claude.ai via `Settings > Capabilities > Skills`.
-4. Or place it in your Claude Code skills directory.
+Recommended Claude Code install via the `vercel-labs/skills` CLI:
+
+```bash
+npx skills add linhay/harmony-next.skills --skill harmony-next -a claude-code -g -y --copy
+```
+
+This installs the skill into Claude Code's global skills directory (current CLI behavior: `~/.claude/skills/harmony-next`).
+
+Claude.ai web can still use the release `harmony-next.skill.zip` upload flow via `Settings > Capabilities > Skills`.
 
 If you only want to attach it as project context:
 
@@ -166,11 +198,17 @@ claude --add-dir /path/to/harmony-next.skills/harmony-next
 
 ### Codex
 
+Recommended Codex install via the `vercel-labs/skills` CLI:
+
+```bash
+npx skills add linhay/harmony-next.skills --skill harmony-next -a codex -g -y --copy
+```
+
 The official Codex Agent Skills docs define skills as the authoring format for reusable workflows. Direct skill folders are for local authoring and discovery; plugins are the installable distribution unit.
 
 Official docs: <https://developers.openai.com/codex/skills>
 
-This repository is not currently packaged as a Codex plugin, so the official Codex setup path is to place it in an official skill scan location.
+This repository is not currently packaged as a Codex plugin. If you do not use `npx skills`, place it in an official skill scan location manually.
 
 Official scan locations:
 

harmony-next/SKILL.md

@@ -21,9 +21,10 @@ For "latest", "current", new API, or online-doc parity questions, compare this l
 
 Install/update entrypoints:
 
+- Vercel Labs skills CLI: `npx skills add linhay/harmony-next.skills --skill harmony-next`; add `-a claude-code -g -y --copy` for a non-interactive global Claude Code install, or `-a codex -g -y --copy` for Codex.
 - Gemini CLI: `gemini skills install https://github.com/linhay/harmony-next.skills --path harmony-next --scope user`
-- Claude.ai / Claude Code: use the release `harmony-next.skill.zip` asset or the `harmony-next/` skill directory.
-- Codex: official Agent Skills docs say direct skill folders are for local authoring/discovery. Put or symlink `harmony-next/` into an official Codex scan location such as `$REPO_ROOT/.agents/skills/harmony-next`, `$HOME/.agents/skills/harmony-next`, or `/etc/codex/skills/harmony-next`; for reusable installable distribution, package it as a Codex plugin.
+- Claude Code: use `npx skills add linhay/harmony-next.skills --skill harmony-next -a claude-code -g -y --copy`; Claude.ai can still use the release `harmony-next.skill.zip` upload flow.
+- Codex: use `npx skills add linhay/harmony-next.skills --skill harmony-next -a codex -g -y --copy`, or put/symlink `harmony-next/` into an official Codex scan location such as `$REPO_ROOT/.agents/skills/harmony-next`, `$HOME/.agents/skills/harmony-next`, or `/etc/codex/skills/harmony-next`; for reusable installable distribution, package it as a Codex plugin.
 
 ## Routing
 

harmony-next/tests/test_skill_metadata.py

@@ -92,6 +92,15 @@ def test_readmes_have_language_switches(self) -> None:
     def test_readmes_document_official_codex_skill_locations(self) -> None:
         readme_text, readme_en_text = self.require_readmes()
         required_readme_fragments = [
+            "Vercel Labs skills CLI",
+            "npx skills add linhay/harmony-next.skills --skill harmony-next",
+            "npx skills add linhay/harmony-next.skills --list",
+            "npx skills add linhay/harmony-next.skills --skill harmony-next -a claude-code -g -y --copy",
+            "npx skills add linhay/harmony-next.skills --skill harmony-next -a codex -g -y --copy",
+            "https://skills.sh/b/linhay/harmony-next.skills",
+            "https://skills.sh/linhay/harmony-next.skills",
+            "https://github.com/vercel-labs/agent-skills",
+            "https://github.com/anthropics/skills",
             "官方 Codex Agent Skills 文档",
             "https://developers.openai.com/codex/skills",
             "$CWD/.agents/skills/harmony-next",
@@ -102,6 +111,15 @@ def test_readmes_document_official_codex_skill_locations(self) -> None:
             "可安装分发单元是 Codex plugin",
         ]
         required_readme_en_fragments = [
+            "Vercel Labs skills CLI",
+            "npx skills add linhay/harmony-next.skills --skill harmony-next",
+            "npx skills add linhay/harmony-next.skills --list",
+            "npx skills add linhay/harmony-next.skills --skill harmony-next -a claude-code -g -y --copy",
+            "npx skills add linhay/harmony-next.skills --skill harmony-next -a codex -g -y --copy",
+            "https://skills.sh/b/linhay/harmony-next.skills",
+            "https://skills.sh/linhay/harmony-next.skills",
+            "https://github.com/vercel-labs/agent-skills",
+            "https://github.com/anthropics/skills",
             "official Codex Agent Skills docs",
             "https://developers.openai.com/codex/skills",
             "$CWD/.agents/skills/harmony-next",
@@ -126,6 +144,10 @@ def test_skill_documents_freshness_and_installation_paths(self) -> None:
             "GitHub Releases or nightly",
             "Huawei online docs",
             "Install/update entrypoints:",
+            "Vercel Labs skills CLI",
+            "npx skills add linhay/harmony-next.skills --skill harmony-next",
+            "npx skills add linhay/harmony-next.skills --skill harmony-next -a claude-code -g -y --copy",
+            "npx skills add linhay/harmony-next.skills --skill harmony-next -a codex -g -y --copy",
             "gemini skills install",
             "Claude.ai",
             "Claude Code",