feat(help): surface agent skill install in clerk --help

.changeset/improve-help-commands.md

@@ -0,0 +1,5 @@
+---
+"clerk": patch
+---
+
+Surface the bundled agent skill in `clerk --help` and bare `clerk` output with a tip pointing to `clerk skill install`, so users discover how to give AI coding agents Clerk context.

README.md

@@ -60,6 +60,9 @@ Commands:
   completion  [shell]                        Generate shell autocompletion script
   update      [options]                      Update the Clerk CLI to the latest version
 
+Give AI agents better Clerk context: install the Clerk skills
+  $ clerk skill install
+
 clerk init
   --framework <name>     Framework to set up (skips auto-detection)
   --pm <manager>         Package manager to use (skips prompt/auto-detection)

packages/cli-core/src/cli-program.ts

@@ -55,7 +55,13 @@ export function createProgram() {
       "--mode <mode>",
       "Force interaction mode (human or agent). Defaults to auto-detect based on TTY.",
     )
-    .option("--verbose", "Show detailed output (enables debug messages)");
+    .option("--verbose", "Show detailed output (enables debug messages)")
+    .addHelpText(
+      "after",
+      `
+Give AI agents better Clerk context: install the Clerk skills
+  $ clerk skill install`,
+    );
 
   program.hook("preAction", async () => {
     // Reset log level at the start of each command invocation so a previous