From ede502a63c35fd82e58368fca8eb3d733322c2fb Mon Sep 17 00:00:00 2001
From: wtgoku <2687861+wtgoku@users.noreply.github.com>
Date: Wed, 29 Apr 2026 13:02:56 +0800
Subject: [PATCH] Show the safe OpenClaw PopiArt skill install path

The public site now points OpenClaw users at the dedicated popiartcli skill directory and raw SKILL.md copy path, so installers do not scan runtime PopiSkills as agent skills.

Constraint: The server worktree already contains unrelated billing and UI edits, so this commit is intentionally limited to the homepage content and renderer.

Rejected: Document only in popiartcli README | users may follow the website install flow instead.

Confidence: high

Scope-risk: narrow

Directive: Keep OpenClaw installation guidance pointed at popiartcli/tree/main/skill, not a repository-root skills directory.

Tested: npm run build in web

Not-tested: Live deployed website smoke test.
---
 web/app/[locale]/page.tsx | 14 ++++++++++++++
 web/lib/site-content.ts   | 13 +++++++++++++
 2 files changed, 27 insertions(+)

diff --git a/web/app/[locale]/page.tsx b/web/app/[locale]/page.tsx
index f1f6049..d382d05 100644
--- a/web/app/[locale]/page.tsx
+++ b/web/app/[locale]/page.tsx
@@ -154,6 +154,20 @@ export default async function HomePage({
             </div>
           </article>
 
+          <article className="integration-step-card">
+            <div className="integration-step-head">
+              <span className="integration-step-dot" aria-hidden="true" />
+              <span className="integration-step-label">OPENCLAW</span>
+              <h3>{dictionary.home.agentSkillTitle}</h3>
+            </div>
+            <div className="integration-step-body">
+              <p>{dictionary.home.agentSkillDescription}</p>
+              <pre>
+                <code>{dictionary.home.agentSkillCommand}</code>
+              </pre>
+            </div>
+          </article>
+
           <article className="integration-step-card">
             <div className="integration-step-head">
               <span className="integration-step-dot" aria-hidden="true" />
diff --git a/web/lib/site-content.ts b/web/lib/site-content.ts
index 235995e..051c1df 100644
--- a/web/lib/site-content.ts
+++ b/web/lib/site-content.ts
@@ -131,6 +131,9 @@ export type AppDictionary = {
     bootstrapTitle: string;
     bootstrapDescription: string;
     bootstrapCommand: string;
+    agentSkillTitle: string;
+    agentSkillDescription: string;
+    agentSkillCommand: string;
     trustTag: string;
     trustTitle: string;
     trustStats: Stat[];
@@ -311,6 +314,11 @@ const zh: AppDictionary = {
     bootstrapDescription: "生成 shell completion、默认 skill discovery profile，并把 PopiArt 直接暴露给 agent。",
     bootstrapCommand:
       "popiart bootstrap --agent codex --completion zsh\npopiart bootstrap --agent codex --discoverable\npopiart skills list",
+    agentSkillTitle: "OpenClaw 手动安装 agent skill",
+    agentSkillDescription:
+      "如果通过 GitHub 目录安装，请指向 popiartcli 仓库的 skill/ 目录；不要使用仓库根目录或 blob/main/skill/SKILL.md，避免安装器扫描到 runtime PopiSkills。",
+    agentSkillCommand:
+      "https://github.com/wtgoku-create/popiartcli/tree/main/skill\n\nmkdir -p ~/.openclaw/skills/popiart-cli\ncurl -fsSL https://raw.githubusercontent.com/wtgoku-create/popiartcli/main/skill/SKILL.md \\\n  -o ~/.openclaw/skills/popiart-cli/SKILL.md",
     trustTag: "CLI DESIGN",
     trustTitle: "围绕 agent 工作流设计，而不是零散脚本拼装",
     trustStats: [
@@ -638,6 +646,11 @@ const en: AppDictionary = {
     bootstrapDescription: "Generate shell completion, a default discovery profile, and make PopiArt directly available to your coding agent.",
     bootstrapCommand:
       "popiart bootstrap --agent codex --completion zsh\npopiart bootstrap --agent codex --discoverable\npopiart skills list",
+    agentSkillTitle: "Manual OpenClaw agent skill install",
+    agentSkillDescription:
+      "If installing from GitHub, point installers at the popiartcli skill/ directory. Do not use the repository root or blob/main/skill/SKILL.md, because some installers scan runtime PopiSkills as agent skills.",
+    agentSkillCommand:
+      "https://github.com/wtgoku-create/popiartcli/tree/main/skill\n\nmkdir -p ~/.openclaw/skills/popiart-cli\ncurl -fsSL https://raw.githubusercontent.com/wtgoku-create/popiartcli/main/skill/SKILL.md \\\n  -o ~/.openclaw/skills/popiart-cli/SKILL.md",
     trustTag: "CLI DESIGN",
     trustTitle: "Designed around agent workflows instead of scattered scripts",
     trustStats: [