diff --git a/packages/commands/src/commands/managed-agent/skill-list.ts b/packages/commands/src/commands/managed-agent/skill-list.ts
index 6548855..f5cf185 100644
--- a/packages/commands/src/commands/managed-agent/skill-list.ts
+++ b/packages/commands/src/commands/managed-agent/skill-list.ts
@@ -42,6 +42,7 @@ export default defineCommand({
     ...CREDENTIALS_NOTE,
     "Providers without a skill listing API (e.g. ark) return an empty list.",
     "For agent-driven skill selection, use `--source all --output json`: one call returns both catalogs with per-skill `source` and `description` fields to pick from.",
+    "When generating a task that needs a suitable skill, call this command to match official or custom skills before wiring them into the task.",
   ],
   validate: (f) =>
     f.source && !SKILL_SOURCES.includes(f.source as SkillSource)
diff --git a/skills/bailian-cli/reference/managed-agent.md b/skills/bailian-cli/reference/managed-agent.md
index e4e911e..7c180c7 100644
--- a/skills/bailian-cli/reference/managed-agent.md
+++ b/skills/bailian-cli/reference/managed-agent.md
@@ -445,6 +445,7 @@ bl managed-agent session send --session-id sess_abc123 --message "continue"
 - Resolved credentials are injected into the SDK in-memory and cleared from the environment; they never persist in process env.
 - Providers without a skill listing API (e.g. ark) return an empty list.
 - For agent-driven skill selection, use `--source all --output json`: one call returns both catalogs with per-skill `source` and `description` fields to pick from.
+- When generating a task that needs a suitable skill, call this command to match official or custom skills before wiring them into the task.
 
 #### Examples