Cross-reference the Clerk CLI and Skills in AI docs

[manovotny]

🔎 Previews:

• https://clerk.com/docs/pr/manovotny-confused-silence/guides/ai/skills
• https://clerk.com/docs/pr/manovotny-confused-silence/cli
• https://clerk.com/docs/pr/manovotny-confused-silence/guides/ai/overview
• https://clerk.com/docs/pr/manovotny-confused-silence/guides/ai/prompts

What does this solve? What changed?

The Skills page is now a top-10 docs page and a primary AI/agent entrypoint, but the CLI ↔ Skills relationship in docs was one-directional and partly broken — Colin flagged that the Skills page never mentions the CLI, which may be suppressing CLI awareness. This tightens that cross-referencing and fixes stale commands.

Cross-referencing + correctness (68f4995, a203c57):

• Skills page — added a CLI back-link (a [!NOTE] callout plus the new /clerk-cli row linking to /docs/cli), so CLI ↔ Skills is now bidirectional.
• Skills table sync — added the three rows missing vs. the clerk/skills repo: clerk-cli, clerk-billing, and clerk-expo (distinct from the existing clerk-expo-patterns — Expo setup vs. patterns), plus matching example prompts.
• CLI page — corrected two removed commands in the AI-agent section: replaced clerk skill install (removed in clerk/cli#315) with the current install paths (the optional clerk init prompt, or npx skills add clerk/skills), and replaced clerk init --prompt (removed in clerk/cli#241) with clerk init -y for non-interactive agent setup.
• AI overview — added a CLI section linking to /docs/cli.

Copy/casing polish on the AI overview (0135f0e):

• Tightened the overview intro.
• Capitalized the Organizations feature reference (proper noun, per the styleguide).
• Kept "AI prompts" lowercase (a descriptive label, not a product) and aligned the prompts.mdx page title to match.

Verified with pnpm run build:tsx and pnpm run lint (both clean), and peer-reviewed via /co-fix.

This also closes the loop on #3418, which added agent nudges pointing to the Skills page "for correct CLI usage" — the destination page now actually surfaces the CLI.

Deadline

• No rush.

Other resources

• DOCS-11816 — this ticket
• DOCS-11814 / #3418 — the <If is="llm"> CLI nudges this closes the loop on
• GROW-1145 — follow-up A/B test (copy-prompt experiment, Growth-owned)
• clerk/cli#315 — removed the clerk skill install command
• clerk/cli#241 — removed clerk init --prompt
• Slack: Colin's thread · docs metrics update

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clerk-docs	Ready	Preview	Jun 10, 2026 8:21pm

[djgould]

This looks good to me!

[SarahSoutoul]

@manovotny One thing - noticed the Expo quickstart mentions clerk-expo-patterns but not clerk-expo? Do we need to add clerk-expo too there?

[manovotny]

@SarahSoutoul Good catch — verified against the repos: npx skills add clerk/skills installs the full bundle, so clerk-expo is already included functionally, but the call-out should name it since it's the Expo setup skill (exactly the quickstart context — clerk-expo-patterns is the advanced follow-on). Updated the nudge in this PR to mention both (4cebd19).

Related: clerk init --framework expo currently maps to clerk-expo-patterns only and never installs clerk-expo — upstream PR to fix (or confirm it's intentional): clerk/cli#328.