@leejungkiin/awkit 1.5.4 → 1.5.6

package/skill-packs/flutter/skills/flutter-project-creater/LICENSE.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/skill-packs/flutter/skills/flutter-project-creater/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: flutter-project-creater
+description: "Provides one-command project creation for Flutter including project initialization, configuration, and template generation. Use when the user asks about creating Flutter projects, needs to initialize a new Flutter project, or generate Flutter project structure."
+license: Complete terms in LICENSE.txt
+---
+
+## When to use this skill
+
+Use this skill whenever the user wants to:
+- Create a new Flutter project from scratch
+- Choose target platforms (Android, iOS, web, desktop)
+- Configure organization name and package identifier
+- Set up the initial project structure with dependencies
+- Generate a Flutter project with a specific template
+
+## How to use this skill
+
+### Workflow
+
+1. **Gather requirements**: project name, organization, target platforms, and any preferred packages
+2. **Run `flutter create`** with the appropriate flags
+3. **Configure `pubspec.yaml`** with initial dependencies and assets
+4. **Verify** the project builds and runs with `flutter run`
+
+### 1. Project Creation
+
+```bash
+# Basic project creation
+flutter create my_app
+
+# With organization and platform selection
+flutter create my_app --org com.example --platforms android,ios,web
+
+# Create a package or plugin
+flutter create --template=package my_package
+flutter create --template=plugin my_plugin --platforms android,ios
+```
+
+### 2. Project Structure
+
+```
+my_app/
+├── lib/
+│   └── main.dart          # Entry point
+├── test/
+│   └── widget_test.dart   # Widget tests
+├── android/               # Android native code
+├── ios/                   # iOS native code
+├── pubspec.yaml           # Dependencies and metadata
+└── README.md
+```
+
+### 3. Configure pubspec.yaml
+
+```yaml
+name: my_app
+description: A new Flutter application.
+version: 1.0.0+1
+
+environment:
+  sdk: '>=3.0.0 <4.0.0'
+
+dependencies:
+  flutter:
+    sdk: flutter
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  flutter_lints: ^3.0.0
+
+flutter:
+  uses-material-design: true
+  assets:
+    - assets/images/
+```
+
+### 4. Initial Run
+
+```bash
+# Install dependencies
+flutter pub get
+
+# Run on connected device
+flutter run
+
+# Build release APK
+flutter build apk --release
+```
+
+## Best Practices
+
+- Use a consistent organization name (`--org`) across projects
+- Lock dependency versions in `pubspec.yaml` for reproducible builds
+- Remove default comments and sample code before expanding the project
+- Run `flutter doctor` to verify the development environment is set up correctly
+- Set up CI with `flutter test` and `flutter build` early in the project lifecycle
+
+## Resources
+
+- Getting started: https://docs.flutter.dev/get-started
+- CLI reference: https://docs.flutter.dev/reference/flutter-cli
+
+## Keywords
+
+flutter create, project creation, initialization, cross-platform, pubspec, scaffolding, Flutter CLI

package/skill-packs/threejs/pack.json

@@ -0,0 +1,25 @@
+{
+    "name": "threejs",
+    "auto_install": false,
+    "description": "Comprehensive 3D web rendering capabilities using Three.js",
+    "skills": [
+        "threejs-animation",
+        "threejs-audio",
+        "threejs-camera",
+        "threejs-controls",
+        "threejs-dev-setup",
+        "threejs-geometries",
+        "threejs-helpers",
+        "threejs-lights",
+        "threejs-loaders",
+        "threejs-materials",
+        "threejs-math",
+        "threejs-node-tsl",
+        "threejs-objects",
+        "threejs-postprocessing",
+        "threejs-renderers",
+        "threejs-scenes",
+        "threejs-textures",
+        "threejs-webxr"
+    ]
+}

package/skill-packs/threejs/skills/README.md

@@ -0,0 +1,95 @@
+# threejs-skills
+
+基于 [three.js 官方文档](https://threejs.org/docs/)（Core / Addons / TSL / Global）与 [Manual](https://threejs.org/manual/) 的 Agent Skills 族。结构与**叙述深度**对齐本仓库 [document-skills/mermaid/SKILL.md](../document-skills/mermaid/SKILL.md)：长 `description`、分层触发词、**与兄弟技能的分流规则**、分步骤工作流、`examples/` 与 `references/` 渐进式披露；每个 `SKILL.md` 另含 **Documentation and version**、**Agent response checklist** 及 **中英 Keywords**（与 mermaid 的英文/中文关键词风格一致）。元数据与目录约定见 [agent-skills-spec.md](../../spec/agent-skills-spec.md)。
+
+## 深度标准（与 mermaid 对齐）
+
+| 要素 | 要求 |
+|------|------|
+| YAML `description` | 多句英文，含关键 API 族名、触发场景、与相邻技能一句区分；**≤1024 字符** |
+| When to use | `ALWAYS` / `Use when`、中英文触发短语、**IMPORTANT** 分流（如 materials vs node-tsl） |
+| How to use | ≥5 步或分场景子步骤；显式指向本目录 `examples/` 中具体文件（若已建） |
+| Doc map | 表格：**官方侧栏分组 + ≥3 条** `https://threejs.org/docs/` 链接 |
+| Scope | In / Out；Out 指向应使用的 `threejs-*` 技能 id |
+| Common pitfalls | 3–5 条易错点（color space、透明排序、mixer.update、WebGPU 路径等按主题选） |
+| Documentation and version | 与 [three.js docs](https://threejs.org/docs/) 及用户 lockfile 版本对齐；大版本升级查 release notes |
+| Agent response checklist | 与 [document-skills/mermaid/SKILL.md](../document-skills/mermaid/SKILL.md) 的「输出要求」类似：链官方页、分流兄弟技能、dispose、不臆造 API |
+| Keywords | **English** + **中文** 两行，便于中英检索 |
+| References（分层） | Manual 入口、`docs/` 侧栏分组、`#` 锚点、必要时 [Global](https://threejs.org/docs/#Global) 常量；长表放 `references/` |
+| 篇幅 | 单 `SKILL.md` 建议 ≤200–350 行；类名长表放 `references/official-sections.md` |
+
+## 文件约定
+
+```
+threejs-<topic>/
+├── SKILL.md
+├── examples/
+│   └── workflow-<scenario>.md   # 步骤 + 片段 + 指向官方示例（不整库粘贴）
+└── references/
+    ├── official-sections.md       # 按需：docs 类名与链接表（animation/loaders/renderers/audio 等）
+    └── ...                        # 如 node-tsl 的 tsl-vs-classic.md、official-links.md
+```
+
+## 技能数量：18（合并策略）
+
+| 决策 | 说明 |
+|------|------|
+| **并入 `threejs-objects`** | `Raycaster`、`Layers`、`EventDispatcher` 与拾取流程在本技能中成章 |
+| **并入 `threejs-geometries`** | `Curve` / `Path` / `Shape` / `ExtrudeGeometry`、Addons NURBS 等在 Scope 与 Doc map 中覆盖 |
+| **独立 `threejs-webxr`** | 不并入 `threejs-renderers`，便于沉浸式任务发现 |
+
+## 技能索引
+
+| # | 目录名 | 主题 |
+|---|--------|------|
+| 1 | [threejs-dev-setup](threejs-dev-setup/SKILL.md) | 构建、导入、Manual、TypeScript、`examples/jsm` |
+| 2 | [threejs-scenes](threejs-scenes/SKILL.md) | `Scene`、`Fog`、`background` |
+| 3 | [threejs-camera](threejs-camera/SKILL.md) | 相机与投影 |
+| 4 | [threejs-lights](threejs-lights/SKILL.md) | 光源与阴影 |
+| 5 | [threejs-materials](threejs-materials/SKILL.md) | 经典材质（非 Node） |
+| 6 | [threejs-node-tsl](threejs-node-tsl/SKILL.md) | Nodes、TSL、`NodeMaterial` |
+| 7 | [threejs-textures](threejs-textures/SKILL.md) | 纹理与采样、PMREM |
+| 8 | [threejs-geometries](threejs-geometries/SKILL.md) | 几何体、Buffer、曲线/挤出 |
+| 9 | [threejs-math](threejs-math/SKILL.md) | 数学类型与空间查询 |
+| 10 | [threejs-objects](threejs-objects/SKILL.md) | 场景图、Mesh、**交互拾取** |
+| 11 | [threejs-animation](threejs-animation/SKILL.md) | 动画混合与轨道 |
+| 12 | [threejs-audio](threejs-audio/SKILL.md) | 空间音频 |
+| 13 | [threejs-loaders](threejs-loaders/SKILL.md) | 加载与导出 |
+| 14 | [threejs-renderers](threejs-renderers/SKILL.md) | WebGL/WebGPU、RenderTarget |
+| 15 | [threejs-postprocessing](threejs-postprocessing/SKILL.md) | EffectComposer 管线 |
+| 16 | [threejs-helpers](threejs-helpers/SKILL.md) | 调试辅助体 |
+| 17 | [threejs-controls](threejs-controls/SKILL.md) | Orbit / Transform 等控件 |
+| 18 | [threejs-webxr](threejs-webxr/SKILL.md) | WebXR |
+
+## 技能互查（分流速览）
+
+| 若用户任务偏向… | 优先技能 | 勿与谁混淆 |
+|------------------|----------|------------|
+| 着色图节点 / TSL / WebGPU 材质 | `threejs-node-tsl` | `threejs-materials`（仅经典材质） |
+| 经典 PBR / ShaderMaterial | `threejs-materials` | `threejs-node-tsl` |
+| 屏幕空间后期（composer passes） | `threejs-postprocessing` | `threejs-renderers`（核心渲染器设置） |
+| 节点化后期（core PostProcessing） | `threejs-node-tsl` + `threejs-renderers` | 仅 composer 的 addon 文档 |
+| HDR / KTX2 / Draco / glTF 进出 | `threejs-loaders` | `threejs-textures`（GPU 纹理对象本身） |
+| 纹理参数 / PMREM | `threejs-textures` | `threejs-loaders`（解码器与文件 IO） |
+| 雾与背景概念 | `threejs-scenes` | 完整 HDR 工作流需 loaders + textures |
+| 射线拾取 / 图层 | `threejs-objects` | `threejs-math`（仅数学对象） |
+| VR/AR 会话与手柄 | `threejs-webxr` | `threejs-camera`（非 XR 投影细节） |
+| 插值与关键帧轨道 | `threejs-animation` | `threejs-math`（Interpolant 归属动画） |
+
+## 验收标准（与规划一致）
+
+每个 `SKILL.md` 应满足：
+
+- **description**：饱满、≤1024 字符；含关键 API 族名与相邻技能一句区分。
+- **When to use**：含至少一处与兄弟技能的分流规则（IMPORTANT 表或段落）。
+- **Doc map**：表格含 **≥3 条** 官方链接（`threejs.org/docs/`、`#` 锚点或 Manual 入口均可；`threejs-dev-setup` 可含 npm Manual）。
+- **How to use**：**≥5 步** 或分场景子列表；显式指向本目录 `examples/*.md`（若存在）。
+- **Scope**：In / Out；Out 中对应能力指向应使用的 `threejs-*` 技能 id。
+- **篇幅**：单文件建议 **约 200–350 行**；类名长表放入 `references/official-sections.md` 等。
+
+## 外部规范链接
+
+- [Agent Skills – Specification](https://agentskills.io/specification)
+- [Claude – 如何创建自定义 Skills](https://support.claude.com/zh-CN/articles/12512198-如何创建自定义-skills)
+- [three.js docs](https://threejs.org/docs/)
+- [three.js manual](https://threejs.org/manual/)

package/skill-packs/threejs/skills/threejs-animation/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: threejs-animation
+description: "three.js keyframe animation system: AnimationMixer, AnimationClip, AnimationAction, KeyframeTrack variants, PropertyBinding, PropertyMixer, AnimationObjectGroup, AnimationUtils; mixing and crossfading clips, loop modes, timeScale, weight; addon AnimationClipCreator and CCDIKSolver for procedural rigs. Use when playing glTF clips, blending actions, or authoring procedural tracks; for skin deformation rigging on meshes see threejs-objects; for math interpolants without clips see threejs-math only when not tied to AnimationMixer."
+---
+
+## When to use this skill
+
+**ALWAYS use this skill when the user mentions:**
+
+- `AnimationMixer.update`, `AnimationAction` play/pause/stop, crossfade, synchronized clips
+- `AnimationClip` from glTF or `AnimationClipCreator`, retargeting caveats at API level
+- Keyframe tracks: position/rotation/scale/color tracks, boolean/string tracks where applicable
+- IK: `CCDIKSolver` / `CCDIKHelper` from addons
+
+**IMPORTANT: animation vs objects**
+
+- **threejs-animation** = time evaluation and tracks.
+- **threejs-objects** = `SkinnedMesh`/`Skeleton` attachment, bind pose—mesh side.
+
+**Trigger phrases include:**
+
+- "AnimationMixer", "AnimationAction", "AnimationClip", "crossFade", "KeyframeTrack"
+- "动画混合", "骨骼动画", "剪辑", "淡入淡出"
+
+## How to use this skill
+
+1. **Collect clips** from `gltf.animations` or create with utilities / `AnimationClipCreator`.
+2. **Create mixer** bound to root object (often `scene` or rig root).
+3. **Create actions** per clip via `mixer.clipAction(clip)`; configure loop mode (`LoopOnce`, `LoopRepeat`, `LoopPingPong`).
+4. **Per frame**: compute delta seconds (use `Clock` from core—documented under Core in docs index), call `mixer.update(delta)`.
+5. **Blending**: adjust `weight`, `crossFadeTo`, `enabled` flags; watch for additive vs full replacement semantics per docs.
+6. **PropertyBinding**: understand path strings targeting bones/morphs—errors often from wrong object names.
+7. **IK addon**: attach solver after base animation if using CCD IK from examples.
+
+See [examples/workflow-mixer-action.md](examples/workflow-mixer-action.md).
+
+## Doc map (official)
+
+| Docs section | Representative links |
+|--------------|----------------------|
+| Animation (index) | https://threejs.org/docs/#Animation |
+| Action | https://threejs.org/docs/AnimationAction.html |
+| Mixer | https://threejs.org/docs/AnimationMixer.html |
+| Clip | https://threejs.org/docs/AnimationClip.html |
+| Tracks | https://threejs.org/docs/KeyframeTrack.html |
+
+More: [references/official-sections.md](references/official-sections.md).
+
+## Scope
+
+- **In scope:** Core Animation module, keyframe pipeline, listed addons for clip creation and IK.
+- **Out of scope:** DCC export best practices; physics ragdoll; audio sync (link conceptually only).
+
+## Common pitfalls and best practices
+
+- Forgetting `mixer.update` freezes animation; double `update` per frame speeds up.
+- Mixing clips with incompatible hierarchies causes violent pops—validate bind pose.
+- Root motion must be handled in game logic if not baked—document explicitly.
+- Large track counts cost CPU—strip unused tracks in preprocessing when possible.
+
+## Documentation and version
+
+Behavior of `AnimationMixer`, tracks, and glTF animation import can change between three.js majors. Treat the [Animation](https://threejs.org/docs/#Animation) section of the [docs index](https://threejs.org/docs/) as authoritative for the user’s installed version; when upgrading, check the three.js repository release notes and migration notes for renamed properties or loader output.
+
+## Agent response checklist
+
+When answering under this skill, prefer responses that:
+
+1. Cite the exact class (`AnimationMixer`, `AnimationAction`, etc.) or addon (`CCDIKSolver`) from the official docs.
+2. Include at least one `https://threejs.org/docs/...` link (e.g. [AnimationAction](https://threejs.org/docs/AnimationAction.html)).
+3. Relate clips to `SkinnedMesh` / skeleton via **threejs-objects** when deformation is involved.
+4. Mention `mixer.update(delta)` and a stable time source (`Clock`) explicitly.
+5. Reference official **examples** by name only (no full file paste).
+
+## References
+
+- https://threejs.org/docs/#Animation
+- https://threejs.org/docs/AnimationMixer.html
+- https://threejs.org/docs/AnimationAction.html
+- https://threejs.org/docs/PropertyBinding.html
+
+## Keywords
+
+**English:** animationmixer, animationaction, animationclip, keyframetrack, crossfade, skinning, propertybinding, three.js
+
+**中文：** 动画混合、AnimationMixer、AnimationAction、关键帧、骨骼动画、剪辑、淡入淡出、three.js

package/skill-packs/threejs/skills/threejs-animation/examples/workflow-mixer-action.md

@@ -0,0 +1,20 @@
+# Workflow: play one glTF clip
+
+## Steps
+
+1. After **threejs-loaders** provides `gltf` with `animations` array non-empty.
+
+2. `const mixer = new THREE.AnimationMixer(gltf.scene);`
+
+3. `const clip = gltf.animations[0]; const action = mixer.clipAction(clip); action.play();`
+
+4. In the render loop: `const delta = clock.getDelta(); mixer.update(delta);` then render (**threejs-renderers**).
+
+5. To switch clips, prepare second `clipAction`, then `action.crossFadeTo(nextAction, duration, false)` per docs.
+
+6. Dispose mixer when discarding the rig if your app hot-swaps characters.
+
+## Anchor
+
+- https://threejs.org/docs/AnimationMixer.html
+- https://threejs.org/docs/AnimationAction.html

package/skill-packs/threejs/skills/threejs-animation/references/official-sections.md

@@ -0,0 +1,19 @@
+# Animation module (core)
+
+- https://threejs.org/docs/AnimationAction.html
+- https://threejs.org/docs/AnimationClip.html
+- https://threejs.org/docs/AnimationMixer.html
+- https://threejs.org/docs/AnimationObjectGroup.html
+- https://threejs.org/docs/AnimationUtils.html
+- https://threejs.org/docs/KeyframeTrack.html
+- https://threejs.org/docs/VectorKeyframeTrack.html
+- https://threejs.org/docs/QuaternionKeyframeTrack.html
+- https://threejs.org/docs/PropertyBinding.html
+- https://threejs.org/docs/PropertyMixer.html
+
+**Addons**
+
+- https://threejs.org/docs/AnimationClipCreator.html
+- https://threejs.org/docs/CCDIKSolver.html
+
+See https://threejs.org/docs/#Animation

package/skill-packs/threejs/skills/threejs-audio/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: threejs-audio
+description: "three.js audio spatialization: AudioListener attached to camera rig, Audio and PositionalAudio sources, AudioAnalyser for FFT/time-domain data, and integration with Web Audio API contexts; AudioLoader is referenced from threejs-loaders for file decoding. Use when placing 3D sound, configuring panner parameters, or building audio visualization; not a replacement for full game audio middleware."
+---
+
+## When to use this skill
+
+**ALWAYS use this skill when the user mentions:**
+
+- `AudioListener` on `Camera`, `Audio` vs `PositionalAudio`, distance models, refDistance/maxDistance/rolloff
+- `AudioAnalyser` for visualization bars/spectrum
+- Browser autoplay policies blocking audio start
+
+**IMPORTANT: audio vs loaders**
+
+| Step | Skill |
+|------|--------|
+| Decode mp3/ogg buffer | **threejs-loaders** (`AudioLoader`) |
+| Spatial playback API | **threejs-audio** |
+
+**Trigger phrases include:**
+
+- "PositionalAudio", "AudioListener", "AudioAnalyser", "panner"
+- "空间音频", "音量衰减", "频谱"
+
+## How to use this skill
+
+1. **Attach listener** to camera object so head-related audio follows view.
+2. **Validate AudioContext state** — check `listener.context.state` before playback; resume if suspended.
+3. **Create context** compatible with user gesture unlock patterns in browsers.
+4. **PositionalAudio** — set `refDistance`, `maxDistance`, `rolloffFactor`, `distanceModel` per docs.
+5. **Load buffer** via `AudioLoader` (**threejs-loaders**), then `positionalAudio.setBuffer`.
+6. **Analyser** — connect graph `listener.context.createAnalyser()` pathways per examples; watch performance.
+7. **Update** — audio nodes usually need no per-frame update unless following moving sources manually.
+
+### Example: PositionalAudio with context validation
+
+```javascript
+import * as THREE from 'three';
+
+const listener = new THREE.AudioListener();
+camera.add(listener);
+
+// Validate AudioContext state before attempting playback
+function ensureAudioContext() {
+  if (listener.context.state === 'suspended') {
+    listener.context.resume();
+  }
+}
+
+// Resume on user gesture (required by browser autoplay policy)
+document.addEventListener('click', ensureAudioContext, { once: true });
+
+const sound = new THREE.PositionalAudio(listener);
+const loader = new THREE.AudioLoader();
+loader.load('sound.mp3', (buffer) => {
+  sound.setBuffer(buffer);
+  sound.setRefDistance(20);
+  sound.setRolloffFactor(1);
+});
+mesh.add(sound); // Attach to a scene object for spatial positioning
+```
+
+See [examples/workflow-positional-audio.md](examples/workflow-positional-audio.md).
+
+## Doc map (official)
+
+| Docs section | Representative links |
+|--------------|----------------------|
+| Audio | https://threejs.org/docs/AudioListener.html |
+| Audio | https://threejs.org/docs/Audio.html |
+| Audio | https://threejs.org/docs/PositionalAudio.html |
+| Audio | https://threejs.org/docs/AudioAnalyser.html |
+
+Extended list: [references/official-sections.md](references/official-sections.md).
+
+## Scope
+
+- **In scope:** Core Audio classes, spatialization parameters, analyser usage overview.
+- **Out of scope:** FMOD/Wwise-style authoring tools.
+
+## Common pitfalls and best practices
+
+- Autoplay restrictions require user interaction to resume AudioContext.
+- Too many positional sources hurt CPU—pool or LOD audio.
+- Ensure world units match distance model expectations.
+
+## Documentation and version
+
+Audio classes are under [Audio](https://threejs.org/docs/#Audio) in [three.js docs](https://threejs.org/docs/). Decoding buffers uses `AudioLoader`—see **threejs-loaders**. Browser Web Audio policies are external but must be mentioned when `AudioContext` is suspended.
+
+## Agent response checklist
+
+When answering under this skill, prefer responses that:
+
+1. Link `AudioListener`, `PositionalAudio`, or `AudioAnalyser` as relevant.
+2. Delegate file loading of sound buffers to **threejs-loaders** (`AudioLoader`).
+3. Note autoplay / user-gesture requirements for resuming context.
+4. Relate distance attenuation to world units and **threejs-objects** placement.
+5. Avoid promising DAW-level mixing—stay within three.js audio scope.
+
+## References
+
+- https://threejs.org/docs/#Audio
+- https://threejs.org/docs/AudioListener.html
+- https://threejs.org/docs/PositionalAudio.html
+
+## Keywords
+
+**English:** audio, positional audio, listener, analyser, spatial sound, web audio, three.js
+
+**中文：** 音频、空间音频、AudioListener、PositionalAudio、Web Audio、three.js