diff --git a/.changeset/improve-help-commands.md b/.changeset/improve-help-commands.md new file mode 100644 index 00000000..639bbe3c --- /dev/null +++ b/.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. diff --git a/README.md b/README.md index 7fcf4a70..ea8d29e1 100644 --- a/README.md +++ b/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 Framework to set up (skips auto-detection) --pm Package manager to use (skips prompt/auto-detection) diff --git a/packages/cli-core/src/cli-program.ts b/packages/cli-core/src/cli-program.ts index 84834c64..4205b577 100644 --- a/packages/cli-core/src/cli-program.ts +++ b/packages/cli-core/src/cli-program.ts @@ -55,7 +55,13 @@ export function createProgram() { "--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