audit-expo-skill

name	audit-expo-skill
description	Audits the bundled `clerk-expo` skill against the @clerk/expo SDK source and clerk-docs, then proposes or applies updates. Use when the user says "audit the expo skill", "update the clerk-expo skill", "check clerk-expo against the SDK", "resync clerk-expo skill", "run audit-expo-skill", or after @clerk/expo ships a minor or major release.
license	MIT
effort	high
user-invocable	true
disable-model-invocation	true
argument-hint	[--sdk <path>] [--docs <path>] [--apply]
metadata	{"internal":true}

Clerk Expo Skill Audit

Cross-check skills/mobile/clerk-expo/ in this repository against the actual @clerk/expo SDK source and the clerk-docs content it cites. The SDK source is the source of truth for API shape; clerk-docs is the source of truth for recommended patterns; the skill must track both. When the two conflict on a factual claim (an API exists, a signature, a default, a version floor), SDK source wins — always. Docs win only on prescriptive questions source cannot answer (which flow to recommend, prop placement in examples, dashboard prerequisites).

The skill intentionally hardcodes verified code snippets (see its freshness gate). This audit is the maintenance half of that contract: it runs after SDK releases so the snippets stay verified rather than becoming folklore.

Inputs

• SDK source of truth: a clerk/javascript checkout containing packages/expo/ (and packages/shared/src/types/ for the sign-in/sign-up resource types).
• Docs source of truth: a clerk/clerk-docs checkout containing docs/getting-started/quickstart.expo.mdx, docs/guides/development/custom-flows/authentication/*.mdx, and docs/reference/expo/**.
• Target skill: skills/mobile/clerk-expo/SKILL.md, references/*.md, and evals/evals.json.
• Optional corroboration: a clerk/clerk-expo-quickstart checkout (three example apps exercising the current API).

Source Checkout Resolution

Resolve each checkout in this order:

1. Use --sdk <path> / --docs <path> when supplied. The SDK path must contain packages/expo/package.json; the docs path must contain docs/getting-started/quickstart.expo.mdx.
2. Look for sibling checkouts of this repository: ../javascript and ../clerk-docs (the standard Clerk projects layout), and ../clerk-expo-quickstart for corroboration.
3. If CLERK_JAVASCRIPT_REPO / CLERK_DOCS_REPO are set, use those paths.
4. If a checkout is missing and network access is acceptable, shallow-clone into .context/:

mkdir -p .context &&  .context
git  --depth 1 https://github.com/clerk/javascript.git
git  --depth 1 https://github.com/clerk/clerk-docs.git