From ae10b679fec197163c58f738ba4deebbefed8079 Mon Sep 17 00:00:00 2001 From: Rafael Thayto Date: Mon, 20 Apr 2026 18:53:28 -0300 Subject: [PATCH] feat(help): surface the agent skill in `clerk --help` and bare `clerk` Append a one-line tip under the Commands section pointing to `clerk skill install`, so users discover how to give AI coding agents Clerk context without hunting through the subcommand tree. --- .changeset/improve-help-commands.md | 5 +++++ README.md | 3 +++ packages/cli-core/src/cli-program.ts | 8 +++++++- 3 files changed, 15 insertions(+), 1 deletion(-) create mode 100644 .changeset/improve-help-commands.md 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