cocos-asset-json

Inspect Cocos Creator Prefab, Scene, and SpriteAtlas assets for UUID and __id__ reference integrity.

63|6|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/xiayu519/Tyou --skill cocos-asset-json
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cocos-asset-json
Source: https://github.com/xiayu519/Tyou/tree/main/.agents/skills/cocos-asset-json
Command: npx skills add https://github.com/xiayu519/Tyou --skill cocos-asset-json

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

这个 skill 专注于 Cocos Creator 源资产的结构解析和只读校验,帮助你快速发现资源引用关系、id/UUID 的一致性以及资源索引的潜在问题。

Core Features & Use Cases

  • 只读分析:对 Prefab、Scene、meta、asset-index.json 以及 SpriteAtlas plist 和 plist.meta 的结构进行检查与汇总,暴露 id 引用和 uuid 关系。
  • 多流程支持:提供 inspect、validate、uuid-index、asset-index、atlas 等命令的快速入口,便于排查资源问题。
  • 参考指引:在需要时可查阅 references 目录中的文档以了解 prefab/scene 的工作流和资源 API 细节。

Quick Start

Run the provided Python scripts to inspect or validate a target asset such as a prefab or scene.

Frequently Asked Questions about cocos-asset-json

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate __id__ references and UUIDs in Cocos Creator prefab and scene files?

To validate Cocos Creator prefab and scene files, run the included Python scripts to perform read-only analysis that cross-references UUIDs and __id__ references, outputting a JSON report with surfaced issues.

What is a read-only way to inspect Cocos asset-index and SpriteAtlas plist integrity?

Read-only inspection of Cocos asset-index and SpriteAtlas plist involves analyzing the file structures and meta UUIDs without modifying them, generating JSON reports that highlight missing references and index inconsistencies.

How do I check Cocos Creator meta UUIDs against asset-index entries?

You can check meta UUIDs against asset-index entries by executing the uuid-index and asset-index commands provided in the Skill's Python scripts, which verify UUID consistency and output issues in a JSON report.

Can I use Python scripts to troubleshoot Cocos Creator resource references without modifying the assets?

Yes, you can use Python scripts to perform read-only analysis on Cocos Creator resources, verifying structure and cross-referencing UUIDs in Prefab, Scene, and SpriteAtlas assets while leaving the original files unmodified.

What are the limitations of validating Cocos Creator prefab __id__ references with this approach?

The limitation of this validation approach is that it performs read-only analysis exclusively, meaning it can identify and report __id__ reference issues in JSON format but cannot automatically repair the broken UUIDs or asset-index mismatches it finds.