Document Codex and Claude skill installation

Author: ysc20020730

README.md

@@ -54,12 +54,16 @@ to:
     └── SUBMISSION.md
 ```
 
-## Install The Codex Plugin
+## Use As A Skill
 
-After this repository is pushed to GitHub:
+Expression Precision is packaged as a Codex Plugin and the underlying Skill is portable. Codex users can install the plugin from this GitHub repository. Claude Code users can copy the `SKILL.md` folder into Claude's local skills directory.
+
+### Install In Codex
+
+Install from the public GitHub repository:
 
 ```bash
-codex plugin marketplace add <owner>/<repository>
+codex plugin marketplace add 75yang/expression-precision
 codex plugin install expression-precision@expression-precision
 ```
 
@@ -71,6 +75,54 @@ $expression-precision
 I feel like my teammate is difficult, but I cannot explain why.
 ```
 
+You can also ask naturally:
+
+```text
+Use expression-precision to clarify this feedback: The product experience feels bad.
+```
+
+### Manual Codex Install
+
+If you do not want to install the full plugin, copy only the skill folder:
+
+```bash
+mkdir -p ~/.codex/skills/expression-precision
+cp -R plugins/expression-precision/skills/expression-precision/* ~/.codex/skills/expression-precision/
+```
+
+Windows PowerShell:
+
+```powershell
+New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills\expression-precision"
+Copy-Item -Recurse -Force "plugins\expression-precision\skills\expression-precision\*" "$env:USERPROFILE\.codex\skills\expression-precision\"
+```
+
+### Use In Claude Code
+
+Claude Code can use the same Skill body, but it does not use the Codex plugin manifest. Copy the skill folder into Claude's skills directory:
+
+```bash
+mkdir -p ~/.claude/skills/expression-precision
+cp -R plugins/expression-precision/skills/expression-precision/* ~/.claude/skills/expression-precision/
+```
+
+Windows PowerShell:
+
+```powershell
+New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills\expression-precision"
+Copy-Item -Recurse -Force "plugins\expression-precision\skills\expression-precision\*" "$env:USERPROFILE\.claude\skills\expression-precision\"
+```
+
+Then ask Claude Code:
+
+```text
+Use expression-precision to clarify this:
+
+I feel stuck about this decision.
+```
+
+The portable part is `plugins/expression-precision/skills/expression-precision/SKILL.md` plus its `references/` folder. The Codex-specific plugin metadata lives in `plugins/expression-precision/.codex-plugin/plugin.json`.
+
 ## Run The Web Demo
 
 ```bash
@@ -166,3 +218,70 @@ Expression Precision 是一个帮助用户把模糊感觉、想法、反馈和
 - 可复制表达
 
 公开 Demo 使用服务端环境变量中的比赛专用模型 API Key，访客无需填写任何 Key，打开网页即可体验。Key 不会进入浏览器代码或 GitHub 仓库；成本控制通过每 IP 限流、输入长度限制和阿里云百炼后台预算/预警完成。当前 Demo 支持 OpenAI，也支持通过阿里云百炼 OpenAI-compatible 接口调用 Qwen。
+
+## 中文使用说明
+
+### 在 Codex 中安装
+
+推荐通过 GitHub 仓库安装完整 Codex Plugin：
+
+```bash
+codex plugin marketplace add 75yang/expression-precision
+codex plugin install expression-precision@expression-precision
+```
+
+安装后在 Codex 中调用：
+
+```text
+$expression-precision
+
+我觉得这个同事有点事儿，但说不清具体哪里不对。
+```
+
+也可以自然语言调用：
+
+```text
+Use expression-precision to clarify this: 我觉得这个产品体验不好。
+```
+
+### 手动安装到 Codex
+
+如果只想使用 Skill 本体，可以复制 Skill 文件夹：
+
+```bash
+mkdir -p ~/.codex/skills/expression-precision
+cp -R plugins/expression-precision/skills/expression-precision/* ~/.codex/skills/expression-precision/
+```
+
+Windows PowerShell：
+
+```powershell
+New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills\expression-precision"
+Copy-Item -Recurse -Force "plugins\expression-precision\skills\expression-precision\*" "$env:USERPROFILE\.codex\skills\expression-precision\"
+```
+
+### 在 Claude Code 中使用
+
+Claude Code 可以复用同一套 Skill 说明，但不使用 Codex 的 `.codex-plugin/plugin.json`。把 Skill 文件夹复制到 Claude 的 skills 目录：
+
+```bash
+mkdir -p ~/.claude/skills/expression-precision
+cp -R plugins/expression-precision/skills/expression-precision/* ~/.claude/skills/expression-precision/
+```
+
+Windows PowerShell：
+
+```powershell
+New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills\expression-precision"
+Copy-Item -Recurse -Force "plugins\expression-precision\skills\expression-precision\*" "$env:USERPROFILE\.claude\skills\expression-precision\"
+```
+
+然后在 Claude Code 中使用：
+
+```text
+Use expression-precision to clarify this:
+
+我对这个决定有点卡住。
+```
+
+可移植的核心是 `plugins/expression-precision/skills/expression-precision/SKILL.md` 和同目录下的 `references/` 文件夹；Codex Plugin 的展示、图标和安装元数据在 `plugins/expression-precision/.codex-plugin/plugin.json`。