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

[rafa-thayto]

Summary

• Adds a one-line tip under the Commands: section of clerk --help (and bare clerk with no subcommand) pointing to clerk skill install. Rendered via Commander's addHelpText('after', …) on the root program, so both paths pick it up without duplicating the string.
• Keeps the existing custom help formatter (clerkHelpConfig in packages/cli-core/src/lib/help.ts) untouched — the tip composes as Commander's "after" hook around the custom formatHelp.
• Mirrors the tip in README.md's help snippet to keep the usage docs in sync with the live output (per .claude/rules/commands.md).

Before:

Commands:
  ...
  update      [options]                      Update the Clerk CLI to the latest version
  help        [command]                      Display help for command

After:

Commands:
  ...
  update      [options]                      Update the Clerk CLI to the latest version
  help        [command]                      Display help for command

Give AI agents better Clerk context: install the Clerk skills
  $ clerk skill install

Test plan

• bun run src/cli.ts --help shows the tip after help [command]
• bun run src/cli.ts (no args) shows the same tip and exits 1 (unchanged)
• Subcommand help pages (clerk init --help, clerk config --help, etc.) are unaffected
• bun run format, bun run lint, bun run typecheck, and bun run test all pass locally

[changeset-bot]

🦋 Changeset detected

Latest commit: ae10b67

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
clerk	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[coderabbitai]

Warning

Rate limit exceeded

@rafa-thayto has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 56 minutes and 51 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 56 minutes and 51 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 991e151b-2643-4261-a166-434319514c72

📥 Commits

Reviewing files that changed from the base of the PR and between 95fa2a7 and ae10b67.

📒 Files selected for processing (3)

• .changeset/improve-help-commands.md
• README.md
• packages/cli-core/src/cli-program.ts

📝 Walkthrough

Walkthrough

The changes add instructional help text to the Clerk CLI to surface a new "Clerk skills" feature. A Changesets entry documents the patch release, the README is updated to show the clerk skill install command in CLI documentation, and the CLI program configuration enhances the global --verbose option help text to direct users to install Clerk skills for better AI agent context.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main change: adding an agent skill install tip to the clerk help output.
Description check	✅ Passed	The pull request description clearly explains the changes: adding a tip to clerk --help output via Commander's addHelpText, maintaining existing help formatting, and mirroring changes in README.md. It provides before/after examples and a comprehensive test plan.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}