code-abyss 1.6.16 → 1.7.0

package/skills/domains/data-engineering/SKILL.md

@@ -1,43 +1,205 @@
 ---
 name: data-engineering
 description: 数据工程。Airflow、Dagster、Kafka Streams、Flink、dbt、数据管道、流处理、数据质量。当用户提到数据管道、ETL、流处理、数据质量时路由到此。
+license: MIT
 ---
 
-# 🏗️ 数据工程域 · Data Engineering
+# 数据工程域 · Data Engineering
 
 ## 域概览
 
 数据工程域涵盖数据管道编排、流式处理、数据质量保障三大核心领域。
 
-## 秘典索引
+```
+数据管道层                流处理层              质量保障层
+├── Airflow (调度编排)    ├── Kafka Streams     ├── Great Expectations
+├── Dagster (资产管理)    ├── Flink             ├── dbt
+└── Prefect (现代工作流)  └── Spark Streaming   └── Soda Core
+```
+
+---
+
+## 数据管道编排
+
+### 框架对比
+
+| 特性 | Airflow | Dagster | Prefect |
+|------|---------|---------|---------|
+| 核心模型 | DAG + Task | Asset + Op | Flow + Task |
+| 学习曲线 | 陡峭 | 中等 | 平缓 |
+| 资产管理 | 无 | 原生支持 | 无 |
+| 动态任务 | 支持 | 支持 | 支持 |
+| 本地开发 | 复杂 | 简单 | 简单 |
+| 社区生态 | 最大 | 成长中 | 成长中 |
+
+### Airflow 核心模式
+
+- DAG 定义：`with DAG(dag_id, schedule, default_args) as dag`
+- TaskFlow API：`@task` 装饰器，自动 XCom 传递
+- 动态任务：`@task` + `.expand()` 实现 dynamic task mapping
+- Operators：PythonOperator / BashOperator / SQL / HTTP / S3
+- Sensors：FileSensor / HttpSensor / ExternalTaskSensor
+- 重试策略：`retries=3, retry_delay=timedelta(minutes=5), retry_exponential_backoff=True`
+- 失败回调：`on_failure_callback` 发送告警
+- SLA 监控：`sla=timedelta(hours=2)` + `sla_miss_callback`
+
+### Dagster 核心模式
+
+- Asset 定义：`@asset(group_name, deps)` 声明数据资产
+- MaterializeResult：返回元数据（行数、预览等）
+- Resources：`ConfigurableResource` 管理外部连接
+- Jobs：`define_asset_job(selection=AssetSelection.groups(...))`
+- Schedules：`ScheduleDefinition(job, cron_schedule)`
+- Sensors：`@sensor(job)` 监听外部事件触发
+- Partitions：`DailyPartitionsDefinition` 按日分区
+- Asset Checks：`@asset_check` 验证数据新鲜度/质量
+
+### Prefect 核心模式
+
+- Flow/Task：`@flow` + `@task(retries=3, cache_key_fn=task_input_hash)`
+- 并发：`ConcurrentTaskRunner` + `task.map(items)`
+- Deployments：`Deployment.build_from_flow(schedule=CronSchedule(...))`
+- Blocks：`Secret` / `JSON` 管理配置和密钥
+
+### 调度策略 Checklist
+
+- [ ] Cron 表达式正确（`0 2 * * *` 日批 / `*/15 * * * *` 实时）
+- [ ] 事件驱动：文件到达 / S3 / API 触发
+- [ ] 跨 DAG 依赖：ExternalTaskSensor / Asset deps
+- [ ] 幂等性：UPSERT / 分区覆盖写入
+- [ ] 增量处理：`WHERE updated_at > last_run`
+- [ ] 数据血缘：Dagster 原生 / Airflow Lineage / dbt ref()
+
+---
+
+## 流式处理
+
+### 框架对比
+
+| 特性 | Kafka Streams | Flink | Spark Streaming |
+|------|---------------|-------|-----------------|
+| 部署模式 | 嵌入式(JVM) | 独立集群 | 独立集群 |
+| 状态管理 | RocksDB | 内存/RocksDB | 内存 |
+| Exactly-Once | 支持 | 支持 | 支持 |
+| 窗口类型 | 丰富 | 最丰富 | 基础 |
+| 学习曲线 | 平缓 | 陡峭 | 中等 |
+| Python API | kafka-python | PyFlink | PySpark |
+
+### Kafka Streams 核心模式
+
+- 拓扑构建：`StreamsBuilder` → `stream()` → `filter/map/flatMap` → `to()`
+- 聚合：`groupByKey().count()` / `.aggregate()` / `.reduce()`
+- Join：Stream-Stream（时间窗口）/ Stream-Table / Table-Table
+- 状态存储：`Stores.persistentKeyValueStore` + Transformer
+- Exactly-Once：`PROCESSING_GUARANTEE_CONFIG = EXACTLY_ONCE_V2`
+- 性能调优：`NUM_STREAM_THREADS=4` / `CACHE_MAX_BYTES_BUFFERING` / RocksDB 配置
 
-| 秘典 | 覆盖范围 | 触发词 |
-|------|----------|--------|
-| [data-pipeline.md](./data-pipeline.md) | Airflow/Dagster/Prefect/调度编排 | 数据管道、Airflow、Dagster、Prefect、ETL、数据编排 |
-| [stream-processing.md](./stream-processing.md) | Kafka Streams/Flink/实时处理 | 流处理、Kafka Streams、Flink、实时处理、流式计算 |
-| [data-quality.md](./data-quality.md) | Great Expectations/dbt/数据验证 | 数据质量、Great Expectations、dbt、数据验证、数据测试 |
+### Flink 核心模式
 
-## 技术栈
+- DataStream API：`env.addSource()` → `filter/map` → `addSink()`
+- 窗口类型：
+  - 滚动窗口 `TumblingProcessingTimeWindows.of(Time.minutes(5))`
+  - 滑动窗口 `SlidingProcessingTimeWindows.of(size, slide)`
+  - 会话窗口 `ProcessingTimeSessionWindows.withGap(gap)`
+  - 全局窗口 `GlobalWindows.create()` + 自定义 Trigger
+- 窗口聚合：`aggregate(AggregateFunction, WindowFunction)` 增量+全窗口
+- ProcessFunction：低级 API，访问时间戳、注册定时器
+- 状态管理：ValueState / ListState / MapState + TTL 清理
+- Checkpoint：`env.enableCheckpointing(60000)` + EXACTLY_ONCE
+- Savepoint：`flink run -s /path/to/savepoint`
+- 时间语义：Event Time + Watermark（`forBoundedOutOfOrderness`）
+- 延迟数据：`allowedLateness()` + `sideOutputLateData()`
+- 数据倾斜：添加随机前缀打散 key
+
+### 流处理 Checklist
+
+- [ ] 选择时间语义：Event Time vs Processing Time
+- [ ] Watermark 策略：乱序容忍度设置
+- [ ] 窗口类型匹配业务场景
+- [ ] 状态 TTL 防止无限增长
+- [ ] Checkpoint 间隔和超时配置
+- [ ] Exactly-Once 语义端到端保证
+- [ ] 背压监控和处理
+- [ ] 并行度调优
+
+---
+
+## 数据质量
+
+### 质量维度
 
 ```
-数据管道层
-├── Airflow (调度编排)
-├── Dagster (资产管理)
-└── Prefect (现代工作流)
-
-流处理层
-├── Kafka Streams (轻量级)
-├── Flink (分布式流处理)
-└── Spark Streaming (批流一体)
-
-质量保障层
-├── Great Expectations (数据验证)
-├── dbt (数据转换测试)
-└── Soda (数据可观测性)
+完整性(非空) → 准确性(范围) → 一致性(关联) → 及时性(新鲜度) → 有效性(格式)
 ```
 
-## 使用指南
+### 工具对比
+
+| 工具 | 优势 | 适用场景 |
+|------|------|----------|
+| Great Expectations | 丰富 Expectations、Data Docs | Python 生态、复杂验证 |
+| dbt | SQL 原生、血缘追踪 | 数据仓库、转换测试 |
+| Soda Core | 简洁 YAML 配置 | 快速验证、CI/CD |
+
+### Great Expectations 核心模式
+
+- Data Context：`gx.get_context()` → 添加数据源 → 构建批次
+- 常用 Expectations：
+  - `expect_table_row_count_to_be_between(min, max)`
+  - `expect_column_values_to_not_be_null(column)`
+  - `expect_column_values_to_be_unique(column)`
+  - `expect_column_values_to_be_between(column, min, max)`
+  - `expect_column_values_to_be_in_set(column, value_set)`
+  - `expect_column_values_to_match_regex(column, regex)`
+- Checkpoints：批量运行验证 + 生成 Data Docs
+- 自定义 Expectation：继承 `ColumnMapExpectation`
+
+### dbt 测试核心模式
+
+- Schema 测试：`unique` / `not_null` / `accepted_values` / `relationships`
+- Generic 测试：`{% test name(model, column_name, params) %}`
+- Singular 测试：`tests/` 目录下自定义 SQL，返回行 = 失败
+- dbt_expectations 包：`expect_column_mean_to_be_between` / `expect_row_values_to_have_recent_data`
+- 执行：`dbt test` / `dbt test --select model` / `dbt test --store-failures`
+- 血缘：`{{ ref('model') }}` + `{{ source('schema', 'table') }}` → `dbt docs generate`
+
+### Soda Core 核心模式
+
+```yaml
+checks for table_name:
+  - row_count > 100
+  - missing_count(column) = 0
+  - duplicate_count(column) = 0
+  - invalid_count(column) = 0:
+      valid format: email
+  - freshness(timestamp_col) < 1d
+```
+
+### 数据质量 Checklist
+
+- [ ] 分层验证：源数据 → 转换后 → 目标数据
+- [ ] 完整性：必需列非空、无空字符串
+- [ ] 准确性：数值范围、格式正则、逻辑一致
+- [ ] 一致性：跨表主键匹配、值一致
+- [ ] 及时性：数据新鲜度 < 阈值
+- [ ] 唯一性：主键/业务键无重复
+- [ ] 质量指标：完整性/唯一性/有效性加权评分
+- [ ] 告警：指标低于阈值自动通知（Slack/Email/PagerDuty）
+- [ ] 持续监控：定时执行质量检查
+
+---
+
+## 最佳实践
+
+| 实践 | 说明 |
+|------|------|
+| 幂等性设计 | UPSERT / 分区覆盖，重跑不产生副作用 |
+| 增量处理 | 基于时间戳/CDC 增量提取，减少全量扫描 |
+| 数据血缘 | dbt ref() / Dagster Asset deps 追踪上下游 |
+| 分层验证 | 源→转换→目标每层都验证 |
+| 监控告警 | 管道 SLA + 质量指标 + 延迟告警 |
+| 状态管理 | 流处理状态 TTL + Checkpoint + Savepoint |
+| 容错设计 | 重试策略 + 死信队列 + 回滚方案 |
+
+## 触发词
 
-1. **数据管道开发** → 查阅 data-pipeline.md
-2. **实时流处理** → 查阅 stream-processing.md
-3. **数据质量保障** → 查阅 data-quality.md
+数据管道、Airflow、Dagster、Prefect、ETL、流处理、Kafka Streams、Flink、数据质量、Great Expectations、dbt、数据验证、数据血缘

package/skills/domains/development/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: development
 description: 开发语言能力索引。Python、Go、Rust、TypeScript、Java、C++、Shell。当用户提到编程、开发、代码、语言时路由到此。
+license: MIT
 ---
 
 # 符箓秘典 · 开发语言能力中枢
@@ -16,10 +17,6 @@ description: 开发语言能力索引。Python、Go、Rust、TypeScript、Java
 | [java](java.md) | Java | 企业级、Spring、微服务 |
 | [cpp](cpp.md) | C/C++ | 系统底层、性能优化 |
 | [shell](shell.md) | Bash | 脚本自动化、系统管理 |
-| [php](php.md) | PHP | Laravel、Symfony、Web开发 |
-| [swift](swift.md) | Swift | SwiftUI、iOS开发、Combine |
-| [kotlin](kotlin.md) | Kotlin | Jetpack Compose、Android开发 |
-| [dart](dart.md) | Dart | Flutter、跨平台开发 |
 
 ## 语言选型指南
 

package/skills/domains/devops/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: devops
 description: DevOps 能力索引。Git、测试、DevSecOps、数据库。当用户提到 DevOps、CI/CD、Git、测试时路由到此。
+license: MIT
 ---
 
 # 🔧 炼器秘典 · DevOps 能力中枢
@@ -11,13 +12,10 @@ description: DevOps 能力索引。Git、测试、DevSecOps、数据库。当用
 | Skill | 定位 | 核心能力 |
 |-------|------|----------|
 | [git-workflow](git-workflow.md) | 版本控制 | Git、分支策略、PR |
-| [testing](testing.md) | 软件测试 | 单元测试、集成测试、TDD |
-| [testing-strategy](testing-strategy.md) | 测试策略 | 测试金字塔、测试左移、契约测试 |
-| [e2e-testing](e2e-testing.md) | E2E测试 | Playwright、Cypress、可视化回归 |
-| [performance-testing](performance-testing.md) | 性能测试 | k6、JMeter、负载测试、压力测试 |
+| [testing](testing.md) | 软件测试 | 单元测试、集成测试、TDD、测试策略、E2E测试 |
 | [devsecops](devsecops.md) | 安全开发 | CI/CD安全、供应链安全 |
 | [database](database.md) | 数据库 | SQL、NoSQL、优化 |
-| [performance](performance.md) | 性能优化 | Profiling、火焰图、基准测试 |
+| [performance](performance.md) | 性能优化 | Profiling、火焰图、基准测试、负载测试、性能测试 |
 | [observability](observability.md) | 可观测性 | 日志、指标、追踪、SLO |
 | [cost-optimization](cost-optimization.md) | 成本优化 | FinOps、右尺寸、Spot、伸缩 |
 

package/skills/domains/devops/performance.md

@@ -271,3 +271,66 @@ pool_size = (core_count * 2) + effective_spindle_count
   - [ ] 网络无丢包
 ```
 
+---
+
+## 性能测试（源自 performance-testing）
+
+### 测试类型
+
+| 类型 | 用户数 | 持续时间 | 目标 |
+|------|--------|----------|------|
+| 负载测试 | 预期峰值 | 30min-2h | 验证性能指标 |
+| 压力测试 | 超出峰值 | 1-3h | 找到崩溃点 |
+| 浸泡测试 | 正常负载 | 8-72h | 检测内存泄漏 |
+| 峰值测试 | 瞬间激增 | 短时间 | 测试弹性 |
+
+### k6 核心模式
+
+```javascript
+// 阶梯式负载
+export const options = {
+  stages: [
+    { duration: '2m', target: 100 },
+    { duration: '5m', target: 100 },
+    { duration: '2m', target: 0 },
+  ],
+  thresholds: {
+    http_req_duration: ['p(95)<500'],
+    http_req_failed: ['rate<0.01'],
+  },
+};
+```
+
+### 性能基准阈值
+
+| 场景 | P95响应时间 | 错误率 | 吞吐量 |
+|------|-------------|--------|--------|
+| API查询 | <200ms | <0.1% | >1000 RPS |
+| API写入 | <500ms | <0.5% | >500 RPS |
+| 页面加载 | <2s | <1% | >100 RPS |
+
+### 工具选型
+
+| 工具 | 语言 | 适用场景 |
+|------|------|----------|
+| k6 | JavaScript | 现代化、DevOps集成、云原生 |
+| JMeter | Java/GUI | 功能全面、插件丰富 |
+| Gatling | Scala | 高性能、大规模测试 |
+| Locust | Python | Python生态、分布式 |
+
+### 渐进式测试流程
+
+```
+1. 基准测试 → 单用户建立基准
+2. 负载测试 → 预期负载验证性能
+3. 压力测试 → 超出负载找极限
+4. 浸泡测试 → 长时间检测泄漏
+```
+
+### 测试环境要求
+
+- 独立环境，配置与生产一致
+- 数据分布模拟真实：70%轻度 / 20%中度 / 10%重度用户
+- 数据隔离：`user_${__VU}_${__ITER}`
+- CI集成：k6 GitHub Action + 阈值门禁
+

package/skills/domains/devops/testing.md

@@ -184,3 +184,100 @@ AAA:
 3. 重构: 优化代码，保持测试通过
 ```
 
+---
+
+## 测试策略（源自 testing-strategy）
+
+### 测试金字塔比例
+
+| 层级 | 占比 | 执行时间 | 成本 |
+|------|------|----------|------|
+| 单元测试 | 70% | <1s | 低 |
+| 集成测试 | 20% | 1-10s | 中 |
+| E2E测试 | 10% | 10s-5m | 高 |
+
+### 测试左移 Checklist
+
+```yaml
+需求阶段: 可测试性评审、验收标准定义、测试用例设计
+开发阶段: TDD、单元测试同步编写、代码审查包含测试
+提交阶段: Pre-commit Hook、本地测试必过、静态分析
+CI阶段: 自动化测试、覆盖率门禁、性能基准测试
+```
+
+### 契约测试要点
+
+- 消费者驱动契约 (CDC)：Consumer 定义期望 → Provider 验证契约
+- 工具：Pact（多语言）、Spring Cloud Contract（Java）
+- 核心：Provider API <-> Contract <-> Consumer，双方独立验证
+
+### 覆盖率策略
+
+```yaml
+类型: 行覆盖率、分支覆盖率、函数覆盖率、语句覆盖率
+门禁: 全局 ≥80%，核心模块 ≥90%
+排除: tests/、migrations/、__init__.py、config 文件
+```
+
+### 变异测试
+
+- 修改源码（变异体）验证测试是否能捕获
+- 工具：Stryker (JS)、Pitest (Java)
+- 阈值：high 80% / low 60% / break 50%
+
+### 测试最佳实践
+
+- AAA 模式：Arrange → Act → Assert
+- 命名：`should [预期行为] when [条件]`
+- 单一职责：每个测试只验证一件事
+- 数据隔离：Fixture/Factory 模式，每测试独立实例
+- 并行执行：Jest `maxWorkers: '50%'`、pytest `-n auto`
+
+---
+
+## E2E 测试（源自 e2e-testing）
+
+### Playwright vs Cypress
+
+| 特性 | Playwright | Cypress |
+|------|-----------|---------|
+| 多浏览器 | Chromium/Firefox/WebKit | Chromium/Firefox/Edge |
+| 多标签页/iframe | 原生支持 | 有限 |
+| 并行执行 | 原生支持 | 需付费 |
+| 调试体验 | 一般 | 优秀 |
+
+### 选择器优先级
+
+```
+1. data-testid (推荐)
+2. role + accessible name
+3. 稳定的 class/id
+4. 文本内容 (谨慎)
+5. CSS/XPath (避免)
+```
+
+### E2E Checklist
+
+```yaml
+架构:
+  - 页面对象模式 (POM) 封装页面操作
+  - 测试独立性：通过 API 准备数据，不依赖其他测试
+  - 智能等待：waitForSelector/waitForResponse，禁止 waitForTimeout
+
+网络:
+  - Mock API：page.route() / cy.intercept() 隔离后端
+  - 等待响应：waitForResponse 确认数据加载
+
+可视化回归:
+  - Playwright: toHaveScreenshot() + mask 动态内容
+  - Percy/Chromatic: 云端截图对比
+
+认证:
+  - Playwright: storageState 复用登录态
+  - Cypress: cy.session() 缓存会话
+
+CI集成:
+  - retries: CI 环境 2 次重试
+  - artifacts: 失败时保存截图/视频/trace
+```
+

package/skills/domains/frontend-design/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: frontend-design
 description: 前端设计美学秘典。UI美学、组件模式、UX原则。当魔尊需要前端设计、UI/UX指导、组件设计时使用。
+license: MIT
 user-invocable: true
 ---
 
@@ -14,9 +15,16 @@ user-invocable: true
 | 组件模式 | [component-patterns.md](component-patterns.md) | 布局模板、响应式设计、交互模式、动画、表单设计、卡片组件、导航模式 |
 | UX原则 | [ux-principles.md](ux-principles.md) | 可用性、无障碍、信息架构、用户流程、加载体验、反馈设计、移动端优先、性能感知 |
 | 状态管理 | [state-management.md](state-management.md) | Redux、Zustand、Jotai、Recoil、Context API、性能优化 |
-| 性能优化 | [performance.md](performance.md) | 懒加载、代码分割、虚拟滚动、Web Vitals、资源优化 |
-| 前端测试 | [testing.md](testing.md) | Vitest、Playwright、单元测试、E2E测试、视觉回归 |
-| 构建工具 | [build-tools.md](build-tools.md) | Vite、Webpack、Turbopack、esbuild、构建优化 |
+| 前端工程化 | [engineering.md](engineering.md) | 性能优化、Web Vitals、测试（Vitest/Playwright）、构建工具（Vite/Webpack） |
+
+## 设计风格系统
+
+| 风格 | 文档 | 涵盖 |
+|------|------|------|
+| Claymorphism | [claymorphism/SKILL.md](claymorphism/SKILL.md) | 软陶风格、大圆角、双内阴影、偏移外阴影、暗色模式 |
+| Glassmorphism | [glassmorphism/SKILL.md](glassmorphism/SKILL.md) | 毛玻璃风格、backdrop-filter、透明度、模糊层级 |
+| Neubrutalism | [neubrutalism/SKILL.md](neubrutalism/SKILL.md) | 新粗野主义、粗边框、实色偏移阴影、高饱和色彩 |
+| Liquid Glass | [liquid-glass/SKILL.md](liquid-glass/SKILL.md) | Apple 液态玻璃、半透明深度感知、弹簧动画、环境响应 |
 
 ## 使用场景
 
@@ -26,3 +34,4 @@ user-invocable: true
 - 无障碍改进
 - 响应式布局
 - 交互动画设计
+- 设计风格选型（Claymorphism / Glassmorphism / Neubrutalism / Liquid Glass）

package/skills/domains/frontend-design/claymorphism/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: claymorphism
+description: Claymorphism design system skill. Use when building soft, puffy, clay-like UI components with large radii, dual inner shadows, and offset outer shadows.
+license: MIT
+---
+
+# Claymorphism Design Spec
+
+## 3 Core Elements
+
+1. **Large Radius** — Generous `border-radius` (20–50px) for a puffy, inflated look
+2. **Dual Inner Shadows** — Light inset from top-left + dark inset from bottom-right to simulate 3D clay surface
+3. **Offset Outer Shadow** — Directional `box-shadow` offset (not centered) to ground the element
+
+## CSS Tokens
+
+Reference: [references/tokens.css](references/tokens.css)
+
+```css
+@import 'references/tokens.css';
+
+.clay-card {
+  background: var(--clay-bg-card);
+  border-radius: var(--clay-radius-lg);
+  box-shadow: var(--clay-shadow);
+  color: var(--clay-text);
+}
+```
+
+## Component Examples
+
+### Card
+```css
+.clay-card {
+  background: var(--clay-bg-card);
+  border-radius: var(--clay-radius-lg);
+  box-shadow: var(--clay-shadow);
+  padding: 1.5rem;
+  color: var(--clay-text);
+}
+```
+
+### Button
+```css
+.clay-btn {
+  background: var(--clay-bg-button);
+  border: none;
+  border-radius: var(--clay-radius-pill);
+  box-shadow: var(--clay-shadow);
+  padding: 0.75rem 1.5rem;
+  color: var(--clay-text);
+  cursor: pointer;
+  transition: box-shadow 0.2s;
+}
+.clay-btn:hover {
+  box-shadow: var(--clay-shadow-elevated);
+}
+.clay-btn:active {
+  box-shadow: var(--clay-shadow-pressed);
+}
+```
+
+### Input
+```css
+.clay-input {
+  background: var(--clay-bg);
+  border: none;
+  border-radius: var(--clay-radius);
+  box-shadow: var(--clay-shadow-pressed);
+  padding: 0.75rem 1rem;
+  color: var(--clay-text);
+}
+.clay-input:focus {
+  outline: 2px solid var(--clay-accent);
+  outline-offset: 2px;
+}
+```
+
+### Toggle
+```css
+.clay-toggle {
+  width: 56px;
+  height: 30px;
+  background: var(--clay-bg-card);
+  border-radius: var(--clay-radius-pill);
+  box-shadow: var(--clay-shadow-pressed);
+}
+.clay-toggle-knob {
+  width: 24px;
+  height: 24px;
+  background: var(--clay-bg);
+  border-radius: 50%;
+  box-shadow: var(--clay-shadow);
+  transition: transform 0.2s;
+}
+```
+
+## Dark Mode Notes
+
+- Dark mode reduces inner highlight intensity (`rgba(255,255,255,0.05)` vs `0.6`) to avoid glowing artifacts
+- Outer shadow opacity increases to maintain depth on dark backgrounds
+- Background colors shift to warm dark tones — avoid pure black to preserve the clay feel
+- All dark tokens are defined in `[data-theme="dark"]` in `tokens.css`
+
+## Accessibility Notes
+
+- Ensure **contrast ratio ≥ 4.5:1** for text — clay backgrounds are muted, verify against `--clay-text`
+- Provide visible `:focus` outlines since clay shadows alone don't indicate focus
+- Use `prefers-contrast: more` to flatten shadows and increase text contrast
+
+```css
+@media (prefers-contrast: more) {
+  .clay-card {
+    box-shadow: 0 0 0 2px var(--clay-text);
+  }
+}
+```

package/skills/domains/frontend-design/claymorphism/references/tokens.css

@@ -0,0 +1,52 @@
+:root {
+  /* Backgrounds — soft, muted pastels */
+  --clay-bg: #f0e6db;
+  --clay-bg-card: #e8ddd4;
+  --clay-bg-button: #d4c4b0;
+  --clay-accent: #c4a882;
+
+  /* Radius — large, rounded, puffy */
+  --clay-radius: 20px;
+  --clay-radius-lg: 32px;
+  --clay-radius-pill: 50px;
+
+  /* Shadows — dual inner + offset outer */
+  --clay-shadow:
+    8px 8px 16px rgba(0, 0, 0, 0.12),
+    inset -4px -4px 8px rgba(0, 0, 0, 0.08),
+    inset 4px 4px 8px rgba(255, 255, 255, 0.6);
+  --clay-shadow-elevated:
+    12px 12px 24px rgba(0, 0, 0, 0.15),
+    inset -6px -6px 12px rgba(0, 0, 0, 0.1),
+    inset 6px 6px 12px rgba(255, 255, 255, 0.7);
+  --clay-shadow-pressed:
+    2px 2px 6px rgba(0, 0, 0, 0.1),
+    inset -6px -6px 12px rgba(0, 0, 0, 0.12),
+    inset 6px 6px 12px rgba(255, 255, 255, 0.5);
+
+  /* Text */
+  --clay-text: #4a3f35;
+  --clay-text-muted: #8a7e72;
+}
+
+/* Dark mode */
+[data-theme="dark"] {
+  --clay-bg: #2a2520;
+  --clay-bg-card: #352f28;
+  --clay-bg-button: #443c33;
+  --clay-accent: #6b5d4f;
+  --clay-shadow:
+    8px 8px 16px rgba(0, 0, 0, 0.35),
+    inset -4px -4px 8px rgba(0, 0, 0, 0.25),
+    inset 4px 4px 8px rgba(255, 255, 255, 0.05);
+  --clay-shadow-elevated:
+    12px 12px 24px rgba(0, 0, 0, 0.4),
+    inset -6px -6px 12px rgba(0, 0, 0, 0.3),
+    inset 6px 6px 12px rgba(255, 255, 255, 0.06);
+  --clay-shadow-pressed:
+    2px 2px 6px rgba(0, 0, 0, 0.3),
+    inset -6px -6px 12px rgba(0, 0, 0, 0.35),
+    inset 6px 6px 12px rgba(255, 255, 255, 0.04);
+  --clay-text: #d4c8bc;
+  --clay-text-muted: #8a7e72;
+}