瀏覽代碼

docs: make READMEs runtime-neutral (Agent Skills standard)

Replace Claude-Code-specific framing with cross-runtime language so
the skill is recognized as installable by any skills-compatible agent
(Claude Code, Codex, Cursor, OpenClaw, Hermes, CodeBuddy, Workbuddy,
Gemini CLI, OpenCode, etc.).

- Swap Claude Code badge for Agent Skills + skills.sh + Multi-Runtime
- Add Agent Skills standard tagline under the lead paragraph
- Rewrite Install section: one-line (npx skills add auto-detects),
  manual per-runtime paths, and "use as reference" fallback
- Replace "Then in Claude Code" with runtime-agnostic phrasing
- Annotate sub-skill install table as cross-runtime
- English: rewrite "Nuwa is a Claude Code skill" -> "Nuwa is an
  Agent Skill ... works in 50+ skills-compatible runtimes"

Applied to README.md / README_EN.md / README_ES.md / README_JA.md /
README_KO.md.
alchain 1 月之前
父節點
當前提交
a98beaefb9
共有 5 個文件被更改,包括 245 次插入20 次删除
  1. 53 8
      README.md
  2. 48 3
      README_EN.md
  3. 48 3
      README_ES.md
  4. 48 3
      README_JA.md
  5. 48 3
      README_KO.md

+ 53 - 8
README.md

@@ -11,13 +11,16 @@
 > *「你想蒸馏的下一个员工,何必是同事」*
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-blueviolet)](https://claude.ai/code)
-[![Skills](https://img.shields.io/badge/skills.sh-Compatible-green)](https://skills.sh)
+[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Standard-green)](https://agentskills.io)
+[![skills.sh](https://img.shields.io/badge/skills.sh-Compatible-blue)](https://skills.sh)
+[![Multi-Runtime](https://img.shields.io/badge/Runtime-Claude%20Code%20·%20Codex%20·%20Cursor%20·%20OpenClaw%20·%20Hermes-blueviolet)](#安装)
 
 <br>
 
 **女娲帮你蒸馏任何人的思维方式,让乔布斯、马斯克、芒格、费曼都给你打工。**
 
+<sub>基于开放的 [Agent Skills 协议](https://agentskills.io),可在 Claude Code、Codex、Cursor、OpenClaw、Hermes Agent、CodeBuddy、Workbuddy、Gemini CLI、OpenCode 等 50+ 兼容 runtime 中运行。</sub>
+
 <br>
 
 [同事.skill](https://github.com/titanwings/colleague-skill) 证明了蒸馏一个人是可行的。<br>
@@ -119,11 +122,53 @@ Naval     ❯ 你列了三个欲望。每个欲望都是你跟不快乐签的一
 
 ## 安装
 
+女娲基于开放的 [Agent Skills](https://agentskills.io) 协议,可在任何 skills-compatible 的 AI agent runtime 中运行。
+
+### 方式一:一行命令(推荐,跨 runtime)
+
+打开你正在用的 agent(Claude Code、Codex、Cursor、OpenClaw、Hermes、CodeBuddy、Workbuddy、Gemini CLI、OpenCode 等),告诉它:
+
+```
+帮我安装这个 skill:https://github.com/alchaincyf/nuwa-skill
+```
+
+或者用通用 CLI 安装器([vercel-labs/skills](https://github.com/vercel-labs/skills),支持 55+ runtime):
+
 ```bash
 npx skills add alchaincyf/nuwa-skill
 ```
 
-然后在 Claude Code 里:
+它会自动识别你当前的 runtime 并把 skill 放到正确目录。需要指定时加 `-a claude-code` / `-a codex` / `-a cursor` / `-a openclaw` 等参数。
+
+### 方式二:手动安装
+
+<details>
+<summary>展开查看各 runtime 的 skills 目录</summary>
+
+| Runtime | 安装路径 |
+|---|---|
+| Claude Code | `~/.claude/skills/nuwa-skill/` |
+| Codex CLI | `~/.codex/skills/nuwa-skill/` |
+| Cursor | `~/.cursor/skills/nuwa-skill/` |
+| OpenClaw | `~/.openclaw/workspace/skills/nuwa-skill/` |
+| Hermes Agent | 跑 `tools/install_hermes_skill.py` |
+| 其他 runtime | clone 到对应 runtime 的 `skills/` 目录 |
+
+```bash
+git clone https://github.com/alchaincyf/nuwa-skill <上面对应的路径>
+```
+
+</details>
+
+### 方式三:作为参考资料使用
+
+即使 runtime 不支持 Agent Skills 自动加载,你也可以直接把 `SKILL.md` 的内容粘贴进对话——它本质就是一份 markdown + YAML frontmatter。
+
+---
+
+### 使用
+
+装好后,告诉 agent:
 
 ```
 > 蒸馏一个保罗·格雷厄姆
@@ -169,11 +214,11 @@ npx skills add alchaincyf/nuwa-skill
 
 ## 已蒸馏人物
 
-女娲已蒸馏了13位人物 + 1个主题。每个都是独立的、可直接安装使用的Skill:
+女娲已蒸馏了13位人物 + 1个主题。每个都是独立的、可直接安装使用的Skill,全部基于 Agent Skills 协议,可在 Claude Code / Codex / Cursor / OpenClaw / Hermes 等 runtime 通用
 
 ### 人物Skill
 
-| 人物 | 领域 | 独立仓库 | 一键安装 |
+| 人物 | 领域 | 独立仓库 | 一键安装(跨 runtime) |
 |------|------|---------|---------|
 | 🔥 **Paul Graham** | 创业/写作/产品/人生哲学 | [paul-graham-skill](https://github.com/alchaincyf/paul-graham-skill) | `npx skills add alchaincyf/paul-graham-skill` |
 | 🔥 **张一鸣** | 产品/组织/全球化/人才 | [zhang-yiming-skill](https://github.com/alchaincyf/zhang-yiming-skill) | `npx skills add alchaincyf/zhang-yiming-skill` |
@@ -191,7 +236,7 @@ npx skills add alchaincyf/nuwa-skill
 
 ### 主题Skill
 
-| 主题 | 领域 | 独立仓库 | 一键安装 |
+| 主题 | 领域 | 独立仓库 | 一键安装(跨 runtime) |
 |------|------|---------|---------|
 | **X导师** | X/Twitter运营全栈 | [x-mentor-skill](https://github.com/alchaincyf/x-mentor-skill) | `npx skills add alchaincyf/x-mentor-skill` |
 
@@ -321,11 +366,11 @@ MIT License © [花叔 Huashu](https://github.com/alchaincyf)
 
 **[colleague-skill](https://github.com/titanwings/colleague-skill)** proved that distilling a person into an AI skill is viable. **Nuwa** asks: why stop at colleagues? Distill the best minds in every field — Munger, Feynman, Musk, Naval — people who conveniently left mountains of distillable material behind.
 
-Nuwa is a Claude Code skill that extracts cognitive frameworks — mental models, decision heuristics, expression DNA — from any public figure into a runnable perspective skill.
+Nuwa is an [Agent Skill](https://agentskills.io) that extracts cognitive frameworks — mental models, decision heuristics, expression DNA — from any public figure into a runnable perspective skill. Works in Claude Code, Codex, Cursor, OpenClaw, Hermes Agent, CodeBuddy, Workbuddy, Gemini CLI, OpenCode, and 50+ skills-compatible runtimes.
 
 Not role-playing. Cognitive architecture extraction.
 
-**Install**: `npx skills add alchaincyf/nuwa-skill`
+**Install** (cross-runtime, auto-detects your agent): `npx skills add alchaincyf/nuwa-skill`
 
 **How it works**: Input a name → 6 parallel research agents → 40+ primary sources → triple-verified mental models → quality-validated SKILL.md
 

+ 48 - 3
README_EN.md

@@ -5,13 +5,16 @@
 > *"The next person you want to distill doesn't have to be a colleague."*
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-blueviolet)](https://claude.ai/code)
-[![Skills](https://img.shields.io/badge/skills.sh-Compatible-green)](https://skills.sh)
+[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Standard-green)](https://agentskills.io)
+[![skills.sh](https://img.shields.io/badge/skills.sh-Compatible-blue)](https://skills.sh)
+[![Multi-Runtime](https://img.shields.io/badge/Runtime-Claude%20Code%20·%20Codex%20·%20Cursor%20·%20OpenClaw%20·%20Hermes-blueviolet)](#install)
 
 <br>
 
 **Nuwa distills the thinking of anyone — let Musk, Naval, Munger, and Feynman work for you.**
 
+<sub>Built on the open [Agent Skills](https://agentskills.io) standard. Runs in Claude Code, Codex, Cursor, OpenClaw, Hermes Agent, CodeBuddy, Workbuddy, Gemini CLI, OpenCode, and 50+ skills-compatible runtimes.</sub>
+
 <br>
 
 [colleague-skill](https://github.com/titanwings/colleague-skill) proved that distilling a person into an AI skill is viable.
@@ -64,11 +67,53 @@ This is not role-play. Naval uses his "desire as contract" mental model. Musk us
 
 ## Install
 
+Nuwa is built on the open [Agent Skills](https://agentskills.io) standard. It works in any skills-compatible AI agent runtime.
+
+### Option 1: One-line (recommended, cross-runtime)
+
+Open your skills-compatible agent — Claude Code, Codex, Cursor, OpenClaw, Hermes, CodeBuddy, Workbuddy, Gemini CLI, OpenCode, and 50+ more — and tell it:
+
+```
+Install this skill for me: https://github.com/alchaincyf/nuwa-skill
+```
+
+Or use the universal CLI installer ([vercel-labs/skills](https://github.com/vercel-labs/skills), supports 55+ runtimes):
+
 ```bash
 npx skills add alchaincyf/nuwa-skill
 ```
 
-Then in Claude Code:
+It auto-detects your runtime and places the skill in the correct directory. Add `-a claude-code` / `-a codex` / `-a cursor` / `-a openclaw` to target a specific runtime.
+
+### Option 2: Manual install
+
+<details>
+<summary>Per-runtime skills directories</summary>
+
+| Runtime | Path |
+|---|---|
+| Claude Code | `~/.claude/skills/nuwa-skill/` |
+| Codex CLI | `~/.codex/skills/nuwa-skill/` |
+| Cursor | `~/.cursor/skills/nuwa-skill/` |
+| OpenClaw | `~/.openclaw/workspace/skills/nuwa-skill/` |
+| Hermes Agent | run `tools/install_hermes_skill.py` |
+| Any other | clone into that runtime's `skills/` directory |
+
+```bash
+git clone https://github.com/alchaincyf/nuwa-skill <path-above>
+```
+
+</details>
+
+### Option 3: Use as a reference (no runtime needed)
+
+Even without a skills-aware runtime, you can paste any `SKILL.md` into your prompt context — Nuwa is plain markdown + YAML frontmatter.
+
+---
+
+### Usage
+
+Once installed, tell your agent:
 
 ```
 > Distill Paul Graham

+ 48 - 3
README_ES.md

@@ -5,13 +5,16 @@
 > *"La próxima persona que quieras destilar no tiene por qué ser un colega"*
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-blueviolet)](https://claude.ai/code)
-[![Skills](https://img.shields.io/badge/skills.sh-Compatible-green)](https://skills.sh)
+[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Standard-green)](https://agentskills.io)
+[![skills.sh](https://img.shields.io/badge/skills.sh-Compatible-blue)](https://skills.sh)
+[![Multi-Runtime](https://img.shields.io/badge/Runtime-Claude%20Code%20·%20Codex%20·%20Cursor%20·%20OpenClaw%20·%20Hermes-blueviolet)](#instalación)
 
 <br>
 
 **Nuwa destila la forma de pensar de cualquier persona. Haz que Musk, Naval, Munger y Feynman trabajen para ti.**
 
+<sub>Construido sobre el estándar abierto [Agent Skills](https://agentskills.io). Funciona en Claude Code, Codex, Cursor, OpenClaw, Hermes Agent, CodeBuddy, Workbuddy, Gemini CLI, OpenCode y 50+ runtimes compatibles con skills.</sub>
+
 <br>
 
 [colleague-skill](https://github.com/titanwings/colleague-skill) demostró que destilar a una persona en un skill de IA es viable.
@@ -66,11 +69,53 @@ Esto no es juego de roles. Naval usa su modelo mental "deseo como contrato". Mus
 
 ## Instalación
 
+Nuwa está construido sobre el estándar abierto [Agent Skills](https://agentskills.io). Funciona en cualquier runtime de agente IA compatible con skills.
+
+### Opción 1: Una línea (recomendado, multi-runtime)
+
+Abre tu agente compatible con skills — Claude Code, Codex, Cursor, OpenClaw, Hermes, CodeBuddy, Workbuddy, Gemini CLI, OpenCode y 50+ más — y dile:
+
+```
+Instala este skill: https://github.com/alchaincyf/nuwa-skill
+```
+
+O usa el instalador CLI universal ([vercel-labs/skills](https://github.com/vercel-labs/skills), soporta 55+ runtimes):
+
 ```bash
 npx skills add alchaincyf/nuwa-skill
 ```
 
-En Claude Code:
+Auto-detecta tu runtime y coloca el skill en el directorio correcto. Agrega `-a claude-code` / `-a codex` / `-a cursor` / `-a openclaw` para apuntar a uno específico.
+
+### Opción 2: Instalación manual
+
+<details>
+<summary>Directorios skills por runtime</summary>
+
+| Runtime | Ruta |
+|---|---|
+| Claude Code | `~/.claude/skills/nuwa-skill/` |
+| Codex CLI | `~/.codex/skills/nuwa-skill/` |
+| Cursor | `~/.cursor/skills/nuwa-skill/` |
+| OpenClaw | `~/.openclaw/workspace/skills/nuwa-skill/` |
+| Hermes Agent | ejecuta `tools/install_hermes_skill.py` |
+| Cualquier otro | clonar en el directorio `skills/` de ese runtime |
+
+```bash
+git clone https://github.com/alchaincyf/nuwa-skill <ruta-de-arriba>
+```
+
+</details>
+
+### Opción 3: Usar como referencia (sin runtime)
+
+Incluso sin un runtime con skills automáticos, puedes pegar cualquier `SKILL.md` en tu contexto — Nuwa es markdown plano + YAML frontmatter.
+
+---
+
+### Uso
+
+Una vez instalado, dile a tu agente:
 
 ```
 > Destila a Paul Graham

+ 48 - 3
README_JA.md

@@ -5,13 +5,16 @@
 > *「蒸留すべき次の人物は、同僚である必要はない」*
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-blueviolet)](https://claude.ai/code)
-[![Skills](https://img.shields.io/badge/skills.sh-Compatible-green)](https://skills.sh)
+[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Standard-green)](https://agentskills.io)
+[![skills.sh](https://img.shields.io/badge/skills.sh-Compatible-blue)](https://skills.sh)
+[![Multi-Runtime](https://img.shields.io/badge/Runtime-Claude%20Code%20·%20Codex%20·%20Cursor%20·%20OpenClaw%20·%20Hermes-blueviolet)](#インストール)
 
 <br>
 
 **Nuwaは誰の思考法でも蒸留できる。マスク、Naval、マンガー、ファインマンをあなたのために働かせよう。**
 
+<sub>オープンな [Agent Skills](https://agentskills.io) 標準に基づき構築。Claude Code、Codex、Cursor、OpenClaw、Hermes Agent、CodeBuddy、Workbuddy、Gemini CLI、OpenCode など 50+ の skills 互換 runtime で動作。</sub>
+
 <br>
 
 [colleague-skill](https://github.com/titanwings/colleague-skill) は、人をAIスキルに蒸留することが実現可能だと証明した。
@@ -67,11 +70,53 @@ Naval    ❯ 君は三つの欲望をリストアップした。
 
 ## インストール
 
+Nuwa はオープンな [Agent Skills](https://agentskills.io) 標準に基づき構築されており、skills 互換の任意の AI agent runtime で動作する。
+
+### 方法1:ワンライナー(推奨、クロス runtime)
+
+お使いの agent(Claude Code、Codex、Cursor、OpenClaw、Hermes、CodeBuddy、Workbuddy、Gemini CLI、OpenCode など 50+ 対応)に伝える:
+
+```
+このskillをインストールして:https://github.com/alchaincyf/nuwa-skill
+```
+
+または、汎用 CLI インストーラ([vercel-labs/skills](https://github.com/vercel-labs/skills)、55+ runtime 対応)を使う:
+
 ```bash
 npx skills add alchaincyf/nuwa-skill
 ```
 
-Claude Codeで:
+現在の runtime を自動検出し、正しいディレクトリに skill を配置する。特定 runtime を指定する場合は `-a claude-code` / `-a codex` / `-a cursor` / `-a openclaw` などを付ける。
+
+### 方法2:手動インストール
+
+<details>
+<summary>各 runtime の skills ディレクトリ</summary>
+
+| Runtime | パス |
+|---|---|
+| Claude Code | `~/.claude/skills/nuwa-skill/` |
+| Codex CLI | `~/.codex/skills/nuwa-skill/` |
+| Cursor | `~/.cursor/skills/nuwa-skill/` |
+| OpenClaw | `~/.openclaw/workspace/skills/nuwa-skill/` |
+| Hermes Agent | `tools/install_hermes_skill.py` を実行 |
+| その他 | 該当 runtime の `skills/` ディレクトリに clone |
+
+```bash
+git clone https://github.com/alchaincyf/nuwa-skill <上記のパス>
+```
+
+</details>
+
+### 方法3:参考資料として使う(runtime 不要)
+
+skills を自動ロードしない runtime でも、`SKILL.md` の内容を会話にペーストすればよい——本質はただの markdown + YAML frontmatter。
+
+---
+
+### 使い方
+
+インストール後、agent に伝える:
 
 ```
 > ポール・グレアムを蒸留して

+ 48 - 3
README_KO.md

@@ -5,13 +5,16 @@
 > *"증류할 다음 사람이 꼭 동료일 필요는 없다"*
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-blueviolet)](https://claude.ai/code)
-[![Skills](https://img.shields.io/badge/skills.sh-Compatible-green)](https://skills.sh)
+[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Standard-green)](https://agentskills.io)
+[![skills.sh](https://img.shields.io/badge/skills.sh-Compatible-blue)](https://skills.sh)
+[![Multi-Runtime](https://img.shields.io/badge/Runtime-Claude%20Code%20·%20Codex%20·%20Cursor%20·%20OpenClaw%20·%20Hermes-blueviolet)](#설치)
 
 <br>
 
 **Nuwa는 누구의 사고방식도 증류한다. 머스크, 나발, 멍거, 파인만을 당신을 위해 일하게 하라.**
 
+<sub>오픈된 [Agent Skills](https://agentskills.io) 표준 기반. Claude Code, Codex, Cursor, OpenClaw, Hermes Agent, CodeBuddy, Workbuddy, Gemini CLI, OpenCode 등 50+ 개 skills 호환 runtime 에서 작동.</sub>
+
 <br>
 
 [colleague-skill](https://github.com/titanwings/colleague-skill)은 사람을 AI 스킬로 증류하는 것이 가능하다는 것을 증명했다.
@@ -66,11 +69,53 @@ Naval   ❯ 당신은 세 가지 욕망을 나열했다.
 
 ## 설치
 
+Nuwa는 오픈된 [Agent Skills](https://agentskills.io) 표준 기반으로 구축되어, skills 호환 AI agent runtime 어디에서나 작동한다.
+
+### 방법1: 한 줄 명령(권장, 크로스 runtime)
+
+사용 중인 agent (Claude Code, Codex, Cursor, OpenClaw, Hermes, CodeBuddy, Workbuddy, Gemini CLI, OpenCode 등 50+ 개) 에게 말하라:
+
+```
+이 skill을 설치해 줘: https://github.com/alchaincyf/nuwa-skill
+```
+
+또는 범용 CLI 설치 도구 ([vercel-labs/skills](https://github.com/vercel-labs/skills), 55+ runtime 지원):
+
 ```bash
 npx skills add alchaincyf/nuwa-skill
 ```
 
-Claude Code에서:
+현재 runtime을 자동 감지하여 올바른 디렉터리에 skill을 배치한다. 특정 runtime을 지정하려면 `-a claude-code` / `-a codex` / `-a cursor` / `-a openclaw` 등을 추가한다.
+
+### 방법2: 수동 설치
+
+<details>
+<summary>각 runtime별 skills 디렉터리</summary>
+
+| Runtime | 경로 |
+|---|---|
+| Claude Code | `~/.claude/skills/nuwa-skill/` |
+| Codex CLI | `~/.codex/skills/nuwa-skill/` |
+| Cursor | `~/.cursor/skills/nuwa-skill/` |
+| OpenClaw | `~/.openclaw/workspace/skills/nuwa-skill/` |
+| Hermes Agent | `tools/install_hermes_skill.py` 실행 |
+| 기타 | 해당 runtime의 `skills/` 디렉터리에 clone |
+
+```bash
+git clone https://github.com/alchaincyf/nuwa-skill <위 경로>
+```
+
+</details>
+
+### 방법3: 참고 자료로 사용 (runtime 불필요)
+
+skills를 자동 로드하지 않는 runtime이라도, `SKILL.md` 내용을 대화에 붙여넣으면 된다 — 본질은 그냥 markdown + YAML frontmatter다.
+
+---
+
+### 사용법
+
+설치 후 agent에게:
 
 ```
 > 폴 그레이엄을 증류해 줘