[SarahSoutoul]

What does this solve? What changed?

DOCS-12373 adds a consistent Markdown formatter to clerk/skills. Tables and spacing had drifted without a formatting check.

• Pin Oxfmt 0.77.0 with semi: false, singleQuote: true, and proseWrap: "never". Fenced code examples are formatted too.
• Add format:skills and check:format; the existing pnpm run check includes the formatting check in CI.
• Run pnpm run format:skills across the skills. Split the two mixed server/client examples so the use client directive stays valid, and put the Enterprise SSO firstName and lastName fields on separate lines.
• Replace the hand-added escaped pipe in the Next.js matcher table with separate '/api(.*)' and '/trpc(.*)' patterns that agents can copy directly.
• Wrap eight JSX examples in components so Oxfmt does not add a leading semicolon before bare JSX.

With wide-table padding removed, clerk-billing is at 4,991 estimated tokens and clerk-orgs is at 4,945, both under the 5,000-token limit. This branch passes Check on its own. #118 is stacked on this branch to remove repeated instructions and create room for future edits. It has been updated against the latest #117 branch and is ready for review; merge #118 into this branch before merging #117 into main.

Verification

• pnpm run format:skills completed.
• pnpm test passes (152 tests).
• pnpm run check passes locally. Docs-link redirects are non-blocking warnings.
• Required Check and Test workflows pass on the pushed commit.
• Review the final diff and obtain code owner approval before merging.

Deadline

No fixed deadline. The do not merge label remains until the final diff is reviewed.

Other resources

• DOCS-12373

[SarahSoutoul]

@manovotny This is now using oxfmt!

[manovotny]

Formatting code blocks rewrites three example lines into code an agent shouldn't copy:

• server-vs-client.md lines 25 and 99: 'use client' follows server code in the same block, so it's no longer a directive and becomes ;('use client'). Splitting each into separate server and client blocks fixes it.
• enterprise-sso.md line 43: ssoAccount.firstName, ssoAccount.lastName becomes ;(ssoAccount.firstName, ssoAccount.lastName). One field per line fixes it.

Both fixes pass check:format with the suggested config.

[SarahSoutoul]

@manovotny Fixed the three examples in your review summary: the two server/client examples are now separate code blocks, so use client stays a directive, and the SSO account fields are on separate lines. Commit here.