使用 PlayCanvas Skills
PlayCanvas Skills 是为 AI 编程智能体提供的可移植指令、参考资料和实用工具。它们帮助智能体检查真实项目及已安装的包，采用对应的 PlayCanvas 开发方式，并在运行中的应用中验证结果。
这些技能适用于使用 PlayCanvas Engine、React 和 Web Components 编写的代码项目。它们不会在应用中运行，也不会增加运行时依赖。
PlayCanvas 已收录于 Anthropic 目录。在 Claude Code 中运行 /plugin，打开 Discover，搜索 playcanvas。
创建新项目
最快的入门方式是使用 create-playcanvas：
npm create playcanvas@latest
每个生成的项目都在 .claude/skills/ 中包含供 Claude Code 使用的技能，在 .agents/skills/ 中包含供 Codex、Cursor 及其他支持 Agent Skills 的客户端使用的技能。安装项目依赖，在客户端中打开项目根目录，然后开始新对话，让客户端发现技能。
为现有项目添加技能
在项目根目录中运行 Agent Skills 安装工具：
npx skills add playcanvas/skills
使用 --all 可将全部技能安装到所有检测到的客户端；使用 -g 则进行用户级安装。
安装 Claude Code 插件
PlayCanvas 已收录于 Claude Code 的 Anthropic 目录。在 Claude Code 或 Claude Desktop 的 Code 标签页中运行 /plugin，打开 Discover，搜索 playcanvas。在桌面应用的 Code 标签页中，已安装的插件可通过 + > Plugins 访问。
每个客户端只采用一种安装方式，避免同一技能重复出现。例如，不要同时为 Claude Code 安装 Agent Skills 包和 Claude Code 插件。PlayCanvas Skills 仓库还介绍了 Claude Code、Codex 和 Cursor 的插件市场安装方式。
安装或更新技能后，开始新的智能体对话，让客户端重新加载技能元数据。
技能覆盖范围
技能集合按从项目需求和源资源出发、最终得到经过验证的应用这一过程所需的工作组织：
| 工作流程 | 技能 |
|---|---|
| 应用配置和开发约定 | build-app、apply-conventions |
| 官方示例和引擎功能 | find-examples、reuse-scripts |
| 资源、模型和动画 | load-assets、inspect-glb、calibrate-model、configure-animation |
| 场景组装和运行时检查 | assemble-scene、inspect-runtime |
| 光照和效果 | light-scene、bake-lighting、add-effects、override-shader-chunks |
| 渲染验证和性能 | verify-pixels、reduce-draw-calls |
智能体只加载与当前任务有关的技能。各技能会说明，在选择 API 或实现方式之前，应检查哪些已安装包的声明、引擎源码、脚本或官方示例。
描述期望结果
描述你想得到的结果，以及验收时需要的证据，无需逐个指定技能。例如：
直接使用引擎，为这些 GLB 构建产品查看器。检查并校准每个模型，
复用随引擎提供的相机控制，并在浏览器中验证模型接地和取景。
完善这个 PlayCanvas React 原型：减少绘制调用、池化特效、统一光照，
并通过截图检查效果。
智能体应先检查项目再修改，保留项目当前使用的 Engine、React 或 Web Components 开发方式，运行项目检查，并在浏览器中验证交互或视觉行为。
有关项目上下文、提示词、浏览器工具和验证证据的更多建议，请参阅借助 AI 开发。
适用范围
PlayCanvas Skills 面向基于代码的引擎应用开发流程，不负责自动操作 PlayCanvas Editor 项目、发布应用、管理 PlayCanvas 服务，也不能取代项目自身的美术指导与玩法设计。编辑器中的 AI 辅助工作流程请使用编辑器 MCP 服务器和 VS Code 扩展。
要报告可复现的问题或提出改进建议，请使用技能反馈表单。