Agent skill

Clerk Custom UI

by geekskai in geekskai/blog

Custom authentication flows and component appearance - hooks (useSignIn, useSignUp), themes, colors, fonts, CSS.

MITAuto-check passedFrontend & Design

Install Clerk Custom UI

skills CLI
$ npx skills add geekskai/blog --skill clerk-custom-ui -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install geekskai/blog clerk-custom-ui --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/geekskai/blog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/clerk-custom-ui .claude/skills/clerk-custom-ui && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clerk-custom-ui
GitHub stars
103
Used in
2 other repos
Token cost
~1.6k tokens
SKILL.md length
551 words
Files
6
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

Custom authentication flows and component appearance - hooks (useSignIn, useSignUp), themes, colors, fonts, CSS.

  • Works in 2 steps: Custom authentication flows — build your… → Appearance customization — theme, style,…
  • Custom sign-in/sign-up flows
  • SKILL.md covers What Do You Need?, Custom Flow References, Appearance Customization and Workflow, plus 2 more sections
  • Calls npm

What it does

Clerk Custom UI is an agent skill from geekskai/blog. Custom authentication flows and component appearance - hooks (useSignIn, useSignUp), themes, colors, fonts, CSS. Use for custom sign-in/sign-up flows, appearance styling, visual customization, branding.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files (for example `core-2/custom-sign-in.md`, `core-2/custom-sign-up.md` and `core-3/custom-sign-in.md`).

It sits in Frontend & Design, covering Authentication. The repository describes itself as: 🚀 2026 Most Popular FREE Blog Template! Next.js 14, Zero Code - Just Write & Deploy | 2026最火免费博客模板!支持Markdown,一键部署,极致性能!⚡️ ✨ Write in Markdown, get your professional blog in…. The licence is MIT.

When your agent uses it

  • Custom sign-in/sign-up flows
  • Appearance styling
  • Visual customization

Example prompts

  • “/clerk-custom-ui”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): WebFetch

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Custom authentication flows — build your own sign-in/sign-up UI with hooks
  2. Appearance customization — theme, style, and brand Clerk's pre-built components

What it can do on your machine

Read from SKILL.md and the folder at commit e5554c5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • WebFetch

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • clerk.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Clerk Custom UI loads about 1.6k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 551 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from geekskai/blog at commit e5554c5, republished under its MIT licence (© geekskai). 551 words, ~1,620 tokens.

Download SKILL.mdSave it as .claude/skills/clerk-custom-ui/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
clerk-custom-ui
description
Custom authentication flows and component appearance - hooks (useSignIn, useSignUp), themes, colors, fonts, CSS. Use for custom sign-in/sign-up flows, appearance styling, visual customization, branding.
allowed-tools
WebFetch
license
MIT
metadata.author
clerk
metadata.version
2.3.0

Custom UI

Prerequisite: Ensure ClerkProvider wraps your app. See clerk-setup skill.

Version: Check package.json for the SDK version — see clerk skill for the version table. This determines which custom flow references to use below.

This skill covers two areas:

  1. Custom authentication flows — build your own sign-in/sign-up UI with hooks
  2. Appearance customization — theme, style, and brand Clerk's pre-built components

What Do You Need?

TaskReference
Custom sign-in (Core 2 / LTS)core-2/custom-sign-in.md
Custom sign-up (Core 2 / LTS)core-2/custom-sign-up.md
Custom sign-in (Current SDK v7+)core-3/custom-sign-in.md
Custom sign-up (Current SDK v7+)core-3/custom-sign-up.md
Show component pattern (Current SDK)core-3/show-component.md

Custom Flow References

TaskCore 2Current
Custom sign-in (useSignIn)core-2/custom-sign-in.mdcore-3/custom-sign-in.md
Custom sign-up (useSignUp)core-2/custom-sign-up.mdcore-3/custom-sign-up.md
<Show> component(use <SignedIn>, <SignedOut>, <Protect>)core-3/show-component.md

Appearance Customization

Appearance customization applies to both Core 2 and the current SDK.

Component Customization Options
Appearance Pattern
typescript
<SignIn
  appearance={{
    variables: {
      colorPrimary: '#0000ff',
      borderRadius: '0.5rem',
    },
    options: {
      logoImageUrl: '/logo.png',
      socialButtonsVariant: 'iconButton',
    },
  }}
/>

Core 2 ONLY (skip if current SDK): The options property was named layout. Use layout: { logoImageUrl: '...', socialButtonsVariant: '...' } instead of options.

variables (colors, typography, borders)
PropertyDescription
colorPrimaryPrimary color throughout
colorBackgroundBackground color
borderRadiusBorder radius (default: 0.375rem)

Opacity change: colorRing and colorModalBackdrop now render at full opacity. Use explicit rgba() values if you need transparency.

Core 2 ONLY (skip if current SDK): colorRing and colorModalBackdrop rendered at 15% opacity by default.

options (structure, logo, social buttons)
PropertyDescription
logoImageUrlURL to custom logo
socialButtonsVariant'blockButton' | 'iconButton' | 'auto'
socialButtonsPlacement'top' | 'bottom'
showOptionalFieldsShow optional fields (default: false)

Core 2 ONLY (skip if current SDK): This property is called layout, not options. Also, showOptionalFields defaulted to true.

Themes

Install themes from @clerk/ui:

bash
npm install @clerk/ui
typescript
import { dark } from '@clerk/ui/themes'

<ClerkProvider appearance={{ theme: dark }} />

Core 2 ONLY (skip if current SDK): Themes are imported from @clerk/themes (install @clerk/themes instead of @clerk/ui). Example: import { dark } from '@clerk/themes'.

Theme stacking — pass an array where the last theme takes precedence:

typescript
import { dark, neobrutalism } from '@clerk/ui/themes'

<ClerkProvider appearance={{ theme: [dark, neobrutalism] }} />

CSS color-scheme support — the default theme respects the CSS color-scheme property for automatic light/dark mode toggling.

Available themes: dark, neobrutalism, shadcn, simple

Show full SKILL.md (209 more words)Show less
shadcn Theme

IMPORTANT: If the project has components.json (shadcn/ui installed), ALWAYS apply the shadcn theme as the FIRST customization step. This ensures Clerk components visually match the existing shadcn design system. Skip this only if the user explicitly requests a different theme.

If the project uses shadcn/ui (check for components.json in the project root), always use the shadcn theme:

typescript
import { shadcn } from '@clerk/ui/themes'

<ClerkProvider appearance={{ theme: shadcn }} />

Also import shadcn CSS in your global styles:

css
@import 'tailwindcss';
@import '@clerk/ui/themes/shadcn.css';

Core 2 ONLY (skip if current SDK): Import from @clerk/themes and @clerk/themes/shadcn.css:

typescript
import { shadcn } from '@clerk/themes'
css
@import '@clerk/themes/shadcn.css';

Workflow

  1. Identify customization needs (custom flow or appearance)
  2. For custom flows: check SDK version → read appropriate core-2/ or core-3/ reference
  3. For appearance: WebFetch the appropriate documentation from table above
  4. Apply appearance prop to your Clerk components or build custom flow with hooks

Common Pitfalls

IssueSolution
Colors not applyingUse colorPrimary not primaryColor
Logo not showingPut logoImageUrl inside options: {} (or layout: {} in Core 2)
Social buttons wrongAdd socialButtonsVariant: 'iconButton' in options (or layout in Core 2)
Styling not workingUse appearance prop, not direct CSS (unless with bring-your-own-css)
Hook returns different shapeCheck SDK version — Core 2 and current have completely different useSignIn/useSignUp APIs

See Also

  • clerk-setup - Initial Clerk install
  • clerk-nextjs-patterns - Next.js patterns
  • clerk-orgs - B2B organizations

© geekskai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files in .agents/skills/clerk-custom-ui of geekskai/blog.

  • SKILL.md
  • core-2/custom-sign-in.md
  • core-2/custom-sign-up.md
  • core-3/custom-sign-in.md
  • core-3/custom-sign-up.md
  • core-3/show-component.md

Open the folder on GitHubat commit e5554c5

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in geekskai/blog, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Clerk Custom UI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Clerk Custom UI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clerk Custom UI this skillgeekskai/blog1032 repos~1.6kAutomated safety check: PassMIT
Vue Component Developmentgdarko/laravel-vue-starter145—~1.1kAutomated safety check: PassMIT
Add Eap Methodtalkincode/toughradius691—~802Automated safety check: PassMIT
Code Reusespinspire/pocketbase-sveltekit-starter511—~2.5kAutomated safety check: NotesMIT
Accessible Authentication Reviewthedaviddias/Front-End-Checklist74k—~579Automated safety check: PassMIT
Configuration Authentication Cross Devicegreenpau/caddy-security2.3k—~2.3kAutomated safety check: PassApache-2.0

Similar skills

  • Vue Component Development

    gdarko/laravel-vue-starter

    Activate when creating or modifying Vue 3 components, pages, layouts, stores, or services in the frontend.

    145 GitHub stars~1.1k tokensUpdated 6 mo ago
    Frontend & DesignAuto-check passed
  • Add Eap Method

    talkincode/toughradius

    Add an EAP authentication method (e.g. An agent skill from talkincode/toughradius.

    691 GitHub stars~802 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Code Reuse

    spinspire/pocketbase-sveltekit-starter

    A skill your agent uses when building a UI component, PocketBase hook, page, or app feature and there is proven code to copy from the reference repos.

    511 GitHub stars~2.5k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check: notes
  • Accessible Authentication Review

    thedaviddias/Front-End-Checklist

    Reviews sign-in, MFA, CAPTCHA and recovery flows for accessibility barriers such as blocked paste, memorized codes and transcription, and suggests fixes.

    74k GitHub stars~579 tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Configure and verify optional cross-device portal login, QR activation, explicit approval, browser binding, cancellation, and lifecycle through Caddy.

    2.3k GitHub stars~2.3k tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Blueprint for wiring many apps to one shared login plus a central accounts database, so a person has a single account across every app and access to each app accrues per app (opt-in, deny-by-default).

    494 GitHub stars~5.9k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed

More from geekskai/blog

All 20 skills in this repo
  • React SPA auth patterns with @clerk/react for Vite/CRA - ClerkProvider setup, useAuth/useUser/useClerk hooks, React Router protected routes, custom sign-in flows.

    103 GitHub starsUsed in 1 repo~1k tokens
    Auto-check: notes
  • React Router v7/v8 patterns with Clerk — rootAuthLoader, getAuth in loaders, clerkMiddleware, protected routes, SSR user data, org switching.

    103 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • TanStack React Start auth patterns with @clerk/tanstack-react-start - createServerFn, beforeLoad guards, loaders, Vinxi server.

    103 GitHub starsUsed in 1 repo~875 tokens
    Auto-check: notes
  • Clerk Android

    geekskai/blog

    Implement Clerk authentication for native Android apps using Kotlin and Jetpack Compose with clerk-android source-guided patterns.

    103 GitHub stars~2.1k tokensUpdated 2 days ago
    Auto-check passed
  • Astro patterns with Clerk — middleware, SSR pages, island components, API routes, static vs SSR rendering.

    103 GitHub stars~822 tokensUpdated 2 days ago
    Auto-check: notes
  • Clerk Billing

    geekskai/blog

    Clerk Billing for subscription management - render Clerk's PricingTable and in-app checkout drawer, configure subscription plans, seat-limit plans for B2B, feature entitlements with has(), and…

    103 GitHub stars~5.1k tokensUpdated 2 days ago
    Auto-check passed

Questions about Clerk Custom UI

What does Clerk Custom UI do?

Custom authentication flows and component appearance - hooks (useSignIn, useSignUp), themes, colors, fonts, CSS. Clerk Custom UI is an agent skill from geekskai/blog. Custom authentication flows and component appearance - hooks (useSignIn, useSignUp), themes, colors, fonts, CSS.

When should I use Clerk Custom UI?

Clerk Custom UI fits situations like: custom sign-in/sign-up flows; appearance styling; visual customization.

How do I install Clerk Custom UI in Claude Code?

Run `npx skills add geekskai/blog --skill clerk-custom-ui -a claude-code`. Or copy the skill folder (.agents/skills/clerk-custom-ui in geekskai/blog) into .claude/skills/clerk-custom-ui in your project. Claude Code loads it when a task matches its description.

How do I install Clerk Custom UI in Codex?

Run `npx skills add geekskai/blog --skill clerk-custom-ui -a codex`. Or copy the skill folder (.agents/skills/clerk-custom-ui in geekskai/blog) into .agents/skills/clerk-custom-ui in your project. Codex loads it when a task matches its description.

Can I use Clerk Custom UI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add geekskai/blog --skill clerk-custom-ui -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clerk-custom-ui, .gemini/skills/clerk-custom-ui, .github/skills/clerk-custom-ui and .opencode/skills/clerk-custom-ui in your project.

What does Clerk Custom UI need to run?

Going by SKILL.md and its folder, Clerk Custom UI needs the command-line tools its instructions call (npm). Our summary lists: Node.js. Its frontmatter pre-approves these tools: WebFetch.

Does Clerk Custom UI access the network?

SKILL.md names 1 domain. As links in the text: clerk.com. This is read from the text; nothing was executed.

Is Clerk Custom UI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Clerk Custom UI use?

Clerk Custom UI is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Clerk Custom UI use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Clerk Custom UI?

Skills that share tags, products or a category with Clerk Custom UI: Vue Component Development (gdarko/laravel-vue-starter, 145 stars), Add Eap Method (talkincode/toughradius, 691 stars), Code Reuse (spinspire/pocketbase-sveltekit-starter, 511 stars) and Accessible Authentication Review (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clerk Custom UI?

geekskai (a GitHub user) maintains it in geekskai/blog, which has 103 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 7, 2026.

Source: geekskai/blog on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.