Clerk Swift

What it does

This skill enables AI agents to assist with implementing Clerk authentication in native Swift/iOS projects using ClerkKit and ClerkKitUI. It supports two implementation approaches: prebuilt AuthView components for rapid setup or fully custom native flows for maximum control. The skill guides users through the necessary steps, including verifying project type and ensuring proper package installation and configuration.

When to use it

• You need to integrate Clerk authentication into a Swift/iOS application.
• You prefer using prebuilt AuthView components for quick implementation.
• You require full control over your authentication flow and want to build custom native implementations.
• You're troubleshooting ClerkKit setup in an existing iOS project.

Key capabilities

• Supports both prebuilt AuthView components and fully custom native authentication flows.
• Provides guidance on configuring a valid Clerk publishable key.
• Audits required setup steps by reading the installed clerk-ios package README.
• Verifies project type to ensure compatibility with Swift/iOS development.

Example prompts

• "How do I integrate Clerk authentication into my iOS app?"
• "What are the steps for using the prebuilt AuthView components with Clerk?"
• "I'm building a custom authentication flow in Swift, can you help me configure it?"
• "What Associated Domains capability is required for ClerkKit to work?"

Tips & gotchas

• This skill is specifically designed for native Swift/iOS projects and is not compatible with Expo or React Native. If your project uses either of those frameworks, the agent will redirect you to a general setup skill.
• A valid Clerk publishable key must be directly wired into your app's configuration – it doesn’t use indirect methods like plist or environment files.
• After installation, perform a /v1/environment call to determine feature availability (like Apple Sign In support) by inspecting the ClerkKitUI environment field.