cocos-log-reader

Parse Cocos Creator project.log for errors, warnings, and stack traces.

3|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/eaglhuang/cocos_new --skill cocos-log-reader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cocos-log-reader
Source: https://github.com/eaglhuang/cocos_new/tree/main/.agents/skills/cocos-log-reader
Command: npx skills add https://github.com/eaglhuang/cocos_new --skill cocos-log-reader

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers quickly diagnose runtime issues by reading and analyzing the Cocos Creator project.log for errors, warnings, and stack traces. It is the recommended first step before deeper debugging sessions, especially for bug reports, crashes, UI glitches, and initialization failures.

Core Features & Use Cases

  • Read and parse the Cocos Editor Preview log file (project.log) to capture console outputs (log, warn, error) and preserve history across sessions.
  • Filter logs by symptoms and keywords (e.g., TypeError, Cannot, undefined, null) and examine stack traces to identify the root cause.
  • Apply to scenarios such as CompositePanel mount failures, ChildPanel routing issues, missing assets, or screen wiring problems, guiding targeted fixes.

Quick Start

Describe the runtime symptom and I will analyze the latest project.log to surface errors and stack traces.

Frequently Asked Questions about cocos-log-reader

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

FAQPage Schema
How do I diagnose a runtime crash using the Cocos Creator project.log?

To diagnose a Cocos Creator runtime crash, parse the project.log to capture console outputs and examine stack traces. Filtering log entries by error keywords like TypeError or undefined isolates the root cause of the crash.

What is the best way to find the root cause of UI glitches in Cocos Creator?

Finding the root cause of UI glitches in Cocos Creator involves reading the project.log to filter for warnings and errors. Analyzing stack traces reveals specific mount failures in components like CompositePanel or ChildPanel.

How do I extract stack traces from Cocos logs to fix initialization failures?

Extracting stack traces from Cocos logs to fix initialization failures requires parsing the project.log file. The skill filters runtime logs by specific symptoms and keywords, preserving session history to surface actionable trace insights.

Does this log analysis approach work for missing assets and screen wiring problems?

Yes, this log analysis approach works for missing assets and screen wiring problems. By reading the Cocos Editor Preview log, it captures console errors and warnings, guiding targeted fixes for complex screen routing and initialization issues.

Can I filter Cocos runtime logs by specific error keywords like null or undefined?

You can filter Cocos runtime logs by specific error keywords like null or undefined. The skill reads the project.log file, isolating these symptoms within stack traces to identify the exact source of runtime errors.

Why should I read the project.log before starting a deeper Cocos debugging session?

Reading the project.log before a deeper Cocos debugging session surfaces immediate errors and warnings. It is the recommended first step for bug reports, capturing historical console outputs to pinpoint stack traces quickly.