ColorKit Skill

Overview

This skill provides expert guidance on ColorKit, a powerful, cross-platform Swift library for advanced color management. It covers advanced color creation (Hex, OKLAB, HSL), professional blending modes, precise color space transformations with perceptual gamut mapping, and comprehensive accessibility checks using WCAG and APCA standards. Use this skill to help developers implement sophisticated color logic and ensure UI accessibility across all Apple platforms.

Agent Behavior (Follow These Rules)

1. Clarify Color Space Needs: Always identify if the user needs standard sRGB or wide-gamut (Display P3, Adobe RGB) support before recommending conversion methods.
2. Prioritize CKColor: Encourage the use of CKColor as the unified entry point for all color operations, as it handles platform-specific differences and color space metadata automatically.
3. Recommend Perceptual Mapping: When converting between gamuts, suggest using converted(to:iterations:) for OKLAB-based perceptual mapping to preserve visual intent.
4. Emphasize Accessibility: Proactively mention APCA (isAPCAAccessible) for modern typography contrast needs, alongside traditional WCAG ratios.
5. Dynamic Colors: Always consider system appearance (Light/Dark mode) when suggesting color initializers, favoring those that support adaptive variants.
6. Contextual Bridges: Provide clear examples of bridging CKColor to native types like Color, UIColor, or NSColor when UI integration is the goal.

Project Settings

ColorKit's behavior is influenced by the project's deployment targets and Swift version.

• Deployment Targets: iOS 13.0+, macOS 10.15+, tvOS 13.0+, watchOS 6.0+, and visionOS 1.0+.
• Swift Version: Requires Swift 5.9+.

If these are unknown, ask the developer to confirm them, especially when discussing HDR or wide-gamut features.

Quick Decision Tree

When a developer needs ColorKit guidance, follow this decision tree:

1. Creating a new color?

   • From Hex string/int → references/CKColor.md
   • Using specific models (OKLAB, HSL, CMYK) → references/ColorModels.md
   • Adaptive for Light/Dark mode → references/CKColor.md

2. Converting between color spaces?

   • Basic conversion or Perceptual Gamut Mapping → references/ColorOperations.md
   • Handling wide-gamut (P3, Adobe RGB) → references/ColorOperations.md

3. Performing accessibility checks?

   • WCAG 2.1 Contrast Ratio → references/Accessibility.md
   • APCA (WCAG 3.0) Perceptual Contrast → references/Accessibility.md
   • Font-specific readability → references/Accessibility.md

4. Blending or modifying colors?

   • Photoshop-style blending (Multiply, Overlay, etc.) → references/Blending.md
   • Adjusting opacity, lightness, or saturation → references/ColorOperations.md