From a062c8f34aca2190aff9f4d9db7f56e1b29ff88b Mon Sep 17 00:00:00 2001
From: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
Date: Wed, 9 Sep 2026 19:19:40 +0800
Subject: [PATCH] docs(cli): clarify suite registry compatibility

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
---
 cli/src/commands/help.ts                  |  2 +-
 cli/src/index.ts                          |  2 +-
 cli/test/integration/help-command.test.ts | 10 ++++++++++
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/cli/src/commands/help.ts b/cli/src/commands/help.ts
index 1494cccc..7d70cfb7 100644
--- a/cli/src/commands/help.ts
+++ b/cli/src/commands/help.ts
@@ -46,7 +46,7 @@ export const commands = {
     ]
   },
   suite: {
-    summary: 'Install and manage a Skill Suite locally',
+    summary: 'Manage Skill Suites on compatible registries',
     usage: 'skillhub suite <install|check|upgrade|remove> <coordinate> [options]',
     examples: [
       'skillhub suite install @global/marketing --scope user',
diff --git a/cli/src/index.ts b/cli/src/index.ts
index 0129ced2..0fd549d8 100644
--- a/cli/src/index.ts
+++ b/cli/src/index.ts
@@ -250,7 +250,7 @@ cli
   })
 
 cli
-  .command('suite <action> <coordinate>', 'Install and manage a Skill Suite locally')
+  .command('suite <action> <coordinate>', 'Manage Skill Suites on compatible registries')
   .option('--version <v>', 'Exact Suite version for install')
   .option('--scope <scope>', 'Install scope: user or project')
   .option('--agent <profile>', 'Agent profile (repeatable)')
diff --git a/cli/test/integration/help-command.test.ts b/cli/test/integration/help-command.test.ts
index 8931ca50..0a50779f 100644
--- a/cli/test/integration/help-command.test.ts
+++ b/cli/test/integration/help-command.test.ts
@@ -37,6 +37,16 @@ describe('help command', () => {
     expect(result.stdout).toContain('skillhub search')
   })
 
+  test('states that Suite commands require a compatible registry', async () => {
+    const topic = await runCli(['help', 'suite'])
+    expect(topic.exitCode).toBe(0)
+    expect(topic.stdout).toContain('Manage Skill Suites on compatible registries')
+
+    const root = await runCli(['--help'])
+    expect(root.exitCode).toBe(0)
+    expect(root.stdout).toContain('Manage Skill Suites on compatible registries')
+  })
+
   test('distinguishes skill upgrade from CLI self-update and namespace sync', async () => {
     const upgrade = await runCli(['help', 'upgrade'])
     expect(upgrade.exitCode).toBe(0)