- name
SKILL.md
Tệp skill vẫn nằm trong kho mã của nhà phát hành.
Dán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add coco-research/coco --skill axiom-liquid-glass -a cursor -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add coco-research/coco --skill axiom-liquid-glass -a claude-code -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add coco-research/coco --skill axiom-liquid-glass -a codex -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add coco-research/coco --skill axiom-liquid-glass -a grok -yGửi tin nhắn đã sao chép trong cuộc trò chuyện Grok Bot. Bot sẽ lấy tệp SKILL.md này từ GitHub và thêm vào bộ skill mà mọi Bot của bạn dùng chung.
Install this skill: https://github.com/coco-research/coco/tree/HEAD/skills/axiom-liquid-glassTừ nhà phát hành
Avoid trendy glassmorphism gimmicks. Glass effects should appear only where they improve clarity and depth. Every screen should feel like it belongs in a first-party Apple app.
Liquid Glass is Apple's next-generation material design system introduced at WWDC 2025. It represents a significant evolution from previous materials (Aqua, iOS 7 blurs, Dynamic Island) by creating a new digital meta-material that:
Use glass materials to express depth and context:
Rules:
Liquid Glass defines itself through lensing — the warping and bending of light that communicates presence, motion, and form. Unlike previous materials that scattered light, Liquid Glass uses instinctive visual cues from the natural world.
Liquid Glass continuously adapts without fixed light/dark appearance:
glassEffect Modifier// Basic usage - applies glass within capsule shape
Text("Hello")
.glassEffect()
// Custom shape
Text("Hello")
.glassEffect(in: RoundedRectangle(cornerRadius: 12))
// Interactive elements (iOS)
Button("Tap Me") { }
.glassEffect()
.interactive()
Automatic Adoption: Simply recompiling with Xcode 26 brings Liquid Glass to standard controls automatically.
CRITICAL DECISION: Never mix Regular and Clear in the same interface.
When to use: Navigation bars, tab bars, toolbars, buttons, menus, sidebars
NavigationView {
// Content
}
.glassEffect() // Uses Regular variant by default
Use ONLY when ALL three conditions are met:
ZStack {
MediaRichBackground()
.overlay(.black.opacity(0.3)) // Dimming layer
BoldBrightControl()
.glassEffect(.clear)
}
WARNING: Using Clear without meeting all three conditions results in poor legibility.
[Content Layer — No Glass]
|
[Navigation Layer — Liquid Glass]
- Tab bars, Navigation bars, Toolbars, Floating controls
// WRONG
List(items) { item in
Text(item.name)
}
.glassEffect() // Competes with navigation, muddy hierarchy
// WRONG
ZStack {
NavigationBar().glassEffect()
FloatingButton().glassEffect() // Glass on glass
}
// CORRECT
ZStack {
NavigationBar().glassEffect()
FloatingButton()
.foregroundStyle(.primary) // Use fills, transparency, vibrancy
}
Reposition or scale content to maintain separation. Intersections are acceptable during scrolling/transitions.
Button("Primary Action") { }
.tint(.red)
.glassEffect()
// WRONG - Solid fill breaks glass character
Button("Action") {}
.background(.red) // Opaque
// CORRECT - Transparent, grounded
Button("Action") {}
.tint(.red)
.glassEffect()
Work in concert with Liquid Glass to maintain separation with scrolling content.
Use when pinned accessory views exist:
ScrollView { }
.scrollEdgeEffect(.hard)
Liquid Glass offers accessibility features that modify material without sacrificing its magic:
No developer action required — all features apply automatically when using Liquid Glass.
// WRONG - Deep nesting
ZStack {
GlassContainer1().glassEffect()
ZStack {
GlassContainer2().glassEffect()
}
}
// CORRECT - Flat hierarchy
VStack {
GlassContainer1().glassEffect()
GlassContainer2().glassEffect()
}
func testLiquidGlassAppearance() {
let app = XCUIApplication()
app.launch()
// Test light mode
XCTContext.runActivity(named: "Light Mode Glass") { _ in
let screenshot = app.screenshot()
}
// Test dark mode
app.launchArguments = ["-UIUserInterfaceStyle", "dark"]
app.launch()
XCTContext.runActivity(named: "Dark Mode Glass") { _ in
let screenshot = app.screenshot()
}
}
func testLiquidGlassAccessibility() {
app.launchArguments += [
"-UIAccessibilityIsReduceTransparencyEnabled", "1",
"-UIAccessibilityButtonShapesEnabled", "1",
"-UIAccessibilityIsReduceMotionEnabled", "1"
]
XCTAssertTrue(glassElement.exists)
XCTAssertTrue(glassElement.isHittable)
}
If you hear ANY of these, STOP and reference the skill:
Step 1: Show the Framework
"Let me show you Apple's guidance on Clear variant.
It requires THREE conditions:
1. Media-rich content background
2. Dimming layer for legibility
3. Bold, bright controls on top
Let me show which screens meet all three..."
Step 2: Demonstrate the Risk Open the app on a device. Show Clear variant in low-contrast scenario (unreadable) vs Regular (legible).
Step 3: Offer Compromise
"Clear works beautifully in these hero sections where all three conditions apply.
Regular handles everything else with automatic legibility. Best of both worlds."
Step 4: Document the Decision If overruled, send written documentation of the decision and monitoring plan.
glassEffect(in:isInteractive:)func glassEffect<S: Shape>(
in shape: S = Capsule(),
isInteractive: Bool = false
) -> some View
glassEffect(_:in:isInteractive:)func glassEffect<S: Shape>(
_ variant: GlassVariant, // .regular or .clear
in shape: S = Capsule(),
isInteractive: Bool = false
) -> some View
scrollEdgeEffect(_:)func scrollEdgeEffect(_ style: ScrollEdgeStyle) -> some View
// styles: .automatic, .soft, .hard
scrollEdgeEffectStyle(_:for:) (NEW in iOS 26)func scrollEdgeEffectStyle(_ style: ScrollEdgeStyle, for edges: Edge.Set) -> some View
glassBackgroundEffect() (NEW in iOS 26)Apply glass effect to custom views for reflecting surrounding content.
CustomPhotoGrid()
.glassBackgroundEffect()
GlassEffectContainer (NEW in iOS 26)Container for combining multiple Liquid Glass effects with optimized rendering.
GlassEffectContainer {
HStack {
Button("Action 1") { }.glassEffect()
Button("Action 2") { }.glassEffect()
}
}
Benefits: Optimizes rendering, fluid morphing between glass shapes, reduced compositor overhead.
Spacer(.fixed) in ToolbarsSeparates toolbar button groups with fixed spacing.
.buttonStyle(.borderedProminent) + .tint() in ToolbarsMakes toolbar items prominent with Liquid Glass tinting.
.searchable()).tabRole(.search) — morphs into search field.tabBarMinimizationBehavior(.onScrollDown)enum GlassVariant {
case regular // Default - full adaptive behavior
case clear // More transparent, no adaptation
}
enum ScrollEdgeStyle {
case automatic // System determines
case soft // Gradual fade
case hard // Uniform across toolbar height
}
Add to Info.plist to maintain iOS 18 appearance while building with iOS 26 SDK:
<key>UIDesignRequiresCompatibility</key>
<true/>
Migration strategy:
For each redesigned screen, provide:
WWDC: 2025-219, 2025-323, 2025-256 Docs: /technologyoverviews/adopting-liquid-glass, /swiftui/landmarks-building-an-app-with-liquid-glass, /swiftui/applying-liquid-glass-to-custom-views Related Skills: axiom-liquid-glass-ref, swiftui-liquid-glass Platforms: iOS 26+, iPadOS 26+, macOS Tahoe, visionOS 3 Xcode: 26+
Use when implementing, reviewing, or debugging Apple Liquid Glass: iOS 26+ adoption, Regular vs Clear variants, tinting, scroll edge effects, or an iOS-native redesign review.
---name: axiom-liquid-glassdescription: Use when implementing, reviewing, or debugging Apple Liquid Glass: iOS 26+ adoption, Regular vs Clear…---# skills/axiom-liquid-glass/SKILL.mdCâu hỏi thường gặp
Tải skills/axiom-liquid-glass/SKILL.md từ nhà phát hành, hoặc sao chép đường dẫn và mở kho mã. PlugMCP chỉ liệt kê skill và không lưu trữ tệp này.
Nhà phát hành duy trì nó tại https://github.com/coco-research/coco.
Claude, Cursor, Codex và Grok Build có thể đọc tệp SKILL.md mà bạn thêm từ kho mã của nhà phát hành. Grok Bot cài đặt skill khi bạn gửi liên kết thư mục GitHub của skill trong cuộc trò chuyện.