From ffde071677184a18d86f2e055c44418b05a3519c Mon Sep 17 00:00:00 2001
From: Igor Costa <igor@autohand.ai>
Date: Fri, 3 Jul 2026 14:02:01 +1200
Subject: [PATCH] docs: add Autohand Code install notes

---
 README.md    | 25 +++++++++++++++++++++++++
 README.zh.md | 25 +++++++++++++++++++++++++
 2 files changed, 50 insertions(+)

diff --git a/README.md b/README.md
index dd6cc2f..cc3177c 100644
--- a/README.md
+++ b/README.md
@@ -148,6 +148,30 @@ If your runtime is not listed by `skills@latest` yet, use the manual Agent Skill
 
 </details>
 
+<details>
+<summary><strong>Autohand Code</strong></summary>
+
+Autohand Code reads global skills from `~/.autohand/skills/` and project skills from `<project>/.autohand/skills/`. This skill is not currently listed in the Autohand catalog, so install it by linking the skill folder:
+
+```bash
+git clone https://github.com/wuyoscar/gpt_image_2_skill.git
+cd gpt_image_2_skill
+
+# Global install
+mkdir -p ~/.autohand/skills/
+test -e ~/.autohand/skills/gpt-image && echo "gpt-image skill already exists; stop before overwriting" && exit 1
+ln -s "$PWD/skills/gpt-image" ~/.autohand/skills/gpt-image
+
+# Or project-level install
+mkdir -p .autohand/skills/
+test -e .autohand/skills/gpt-image && echo "gpt-image skill already exists; stop before overwriting" && exit 1
+ln -s "$PWD/skills/gpt-image" .autohand/skills/gpt-image
+```
+
+Autohand Code also supports `autohand --skill-install` for cataloged skills, with `--project` for workspace-level installs. Until this skill is listed there, use the direct link path above.
+
+</details>
+
 <details>
 <summary><strong>Manual agent-skill install</strong></summary>
 
@@ -160,6 +184,7 @@ cd gpt_image_2_skill
 # Choose the skill directory for your runtime.
 # Examples:
 #   Codex:      ~/.codex/skills
+#   Autohand:   ~/.autohand/skills or <project>/.autohand/skills
 #   Claude Code / OpenClaw / Hermes Agent / other runtimes: use that runtime's documented skills directory.
 export AGENT_SKILLS_DIR="/path/to/your/agent/skills"
 
diff --git a/README.zh.md b/README.zh.md
index fc93daf..8a04e46 100644
--- a/README.zh.md
+++ b/README.zh.md
@@ -148,6 +148,30 @@ npx --yes skills@latest add wuyoscar/gpt_image_2_skill \
 
 </details>
 
+<details>
+<summary><strong>Autohand Code</strong></summary>
+
+Autohand Code 会从 `~/.autohand/skills/` 读取全局 skill，也会从 `<project>/.autohand/skills/` 读取当前项目的 skill。这个 skill 目前还没有收录在 Autohand catalog 中，因此请直接软链接 skill 文件夹：
+
+```bash
+git clone https://github.com/wuyoscar/gpt_image_2_skill.git
+cd gpt_image_2_skill
+
+# 全局安装
+mkdir -p ~/.autohand/skills/
+test -e ~/.autohand/skills/gpt-image && echo "gpt-image skill already exists; stop before overwriting" && exit 1
+ln -s "$PWD/skills/gpt-image" ~/.autohand/skills/gpt-image
+
+# 或项目级安装
+mkdir -p .autohand/skills/
+test -e .autohand/skills/gpt-image && echo "gpt-image skill already exists; stop before overwriting" && exit 1
+ln -s "$PWD/skills/gpt-image" .autohand/skills/gpt-image
+```
+
+Autohand Code 也支持通过 `autohand --skill-install` 安装已收录在 Autohand catalog 中的 skill，并可通过 `--project` 安装到当前项目。在这个 skill 收录前，请使用上面的直接软链接方式。
+
+</details>
+
 <details>
 <summary><strong>手动安装 Agent Skill</strong></summary>
 
@@ -160,6 +184,7 @@ cd gpt_image_2_skill
 # 选择你的运行时对应的 skills 目录。
 # 示例：
 #   Codex:      ~/.codex/skills
+#   Autohand:   ~/.autohand/skills 或 <project>/.autohand/skills
 #   Claude Code / OpenClaw / Hermes Agent / 其他运行时：使用该运行时文档指定的 skills 目录。
 export AGENT_SKILLS_DIR="/path/to/your/agent/skills"