Index of every page on this site: llms.txt
All skills
Run it yourself

Generates authentication infrastructure with Sign in with Apple, biometrics, and Keychain storage. Use when user wants to add authentication, login, or Sign in with Apple.

Use this Skill: https://skilld.dev/gh/rshankras/claude-code-apple-skills/auth-flow

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈46 tokens for metadata: the name and description. ≈1.2k when used: this file. ≈2.2k more on demand in 1 file.

Description uses 2.3% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈183 characters, or 2.3%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Auth Flow Generator

Generate a complete authentication flow with Sign in with Apple, biometric authentication (Face ID/Touch ID), and secure Keychain storage.

When This Skill Activates

Use this skill when the user:

  • Asks to "add authentication" or "add login"
  • Mentions "Sign in with Apple" or "SIWA"
  • Wants "Face ID login" or "biometric auth"
  • Asks about "Keychain" or "secure storage"
  • Mentions "user session" or "auth token"

Pre-Generation Checks

1. Project Context Detection

  • Check for existing auth implementations
  • Check for AuthenticationServices framework usage
  • Verify entitlements file exists
  • Identify source file locations

2. Conflict Detection

Search for existing auth:

Glob: **/*Auth*.swift, **/*Keychain*.swift
Grep: "ASAuthorizationController" or "LAContext"

If found, ask user:

  • Replace existing implementation?
  • Extend with additional methods?

3. Required Capabilities

Sign in with Apple requires:

  • Add "Sign in with Apple" capability in Xcode
  • Configure in App Store Connect
  • Add entitlement: com.apple.developer.applesignin

Configuration Questions

Ask user via AskUserQuestion:

  1. Authentication methods? (multi-select)

    • Sign in with Apple
    • Biometrics (Face ID/Touch ID)
    • Both
  2. Session storage?

    • Keychain (secure, persists reinstall)
    • UserDefaults (simple, cleared on reinstall)
  3. Session management?

    • Auto-refresh tokens
    • Manual refresh
    • No token refresh needed

Generation Process

Step 1: Create Core Files

Generate these files:

  1. AuthenticationManager.swift - Core auth orchestration
  2. KeychainManager.swift - Secure storage
  3. SignInWithAppleManager.swift - SIWA handling
  4. BiometricAuthManager.swift - Face ID/Touch ID

Step 2: Create SwiftUI Components

Based on configuration:

  • SignInWithAppleButton.swift - SwiftUI button wrapper
  • AuthenticationView.swift - Complete auth UI

Step 3: Determine File Location

Check project structure:

  • If Sources/ exists → Sources/Auth/
  • If App/ exists → App/Auth/
  • Otherwise → Auth/

Entitlements Required

Sign in with Apple

<!-- YourApp.entitlements -->
<key>com.apple.developer.applesignin</key>
<array>
    <string>Default</string>
</array>

Keychain Sharing (optional)

<key>keychain-access-groups</key>
<array>
    <string>$(AppIdentifierPrefix)com.yourcompany.shared</string>
</array>

Info.plist Required

Face ID Usage Description

<key>NSFaceIDUsageDescription</key>
<string>Use Face ID to securely sign in to your account</string>

Output Format

After generation, provide:

Files Created

Sources/Auth/
├── AuthenticationManager.swift      # Core orchestration
├── KeychainManager.swift            # Secure storage
├── SignInWithAppleManager.swift     # SIWA delegate
├── BiometricAuthManager.swift       # Face ID/Touch ID
├── AuthenticationState.swift        # Auth state model
└── Views/
    ├── SignInWithAppleButton.swift  # SwiftUI button
    └── AuthenticationView.swift     # Complete UI

Integration Steps

App Entry Point:

@main
struct MyApp: App {
    @State private var authManager = AuthenticationManager()  // AuthenticationManager is @Observable

    var body: some Scene {
        WindowGroup {
            if authManager.isAuthenticated {
                ContentView()
            } else {
                AuthenticationView()
            }
        }
        .environment(authManager)
    }
}

Sign in with Apple Button:

SignInWithAppleButtonView { result in
    switch result {
    case .success(let user):
        print("Signed in: \(user.id)")
    case .failure(let error):
        print("Failed: \(error)")
    }
}

Biometric Auth:

Button("Unlock with Face ID") {
    Task {
        if await BiometricAuthManager.shared.authenticate() {
            // Authenticated
        }
    }
}

Required Setup

  1. Xcode Capabilities:

    • Add "Sign in with Apple" capability
    • Enable Keychain Sharing (if needed)
  2. App Store Connect:

    • Configure Sign in with Apple for your App ID
  3. Info.plist:

    • Add NSFaceIDUsageDescription

Testing Instructions

Sign in with Apple:

  • Use Simulator for basic testing
  • Test on device for full flow
  • Use sandbox Apple ID for testing

Biometrics:

  • Simulator: Features > Face ID > Enrolled
  • Test enrolled/not enrolled states
  • Test failed authentication

References

  • auth-patterns.md - Security best practices
  • templates/ - All template files
  • Apple Docs: Authentication Services, LocalAuthentication

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts3mo3 checks · Risk SAFE
  • Gen Agent Trust Hub3mo

    This skill provides a comprehensive and secure framework for generating iOS authentication flows using Sign in with Apple and biometric security. It correctly implements Apple's security best practices, including using the Keychain for encrypted storage and native frameworks for identity management.

  • Socket3mo

    No alerts

  • Snyk3mo

    Risk: LOW · No issues

Signed by skilld at f958982. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 4 months ago
What it can do
Reads files Edits files Runs commands
last_verified
2026-07-16
review_by
2027-06-22
All 7 allowed tools
ReadWriteEditGlobGrepBashAskUserQuestion

README badge

README badge for rshankras/claude-code-apple-skills/auth-flow