hmos-jscrash-analysis

Analyzes HarmonyOS JS Crash faultlogger logs to identify root causes and fixes.

2|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/IsKenKenYa/skills --skill hmos-jscrash-analysis-iskenkenya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hmos-jscrash-analysis
Source: https://github.com/IsKenKenYa/skills/tree/main/skills/harmonyos/solutions/quality/stability/hmos-jscrash-analysis
Command: npx skills add https://github.com/IsKenKenYa/skills --skill hmos-jscrash-analysis-iskenkenya

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? HarmonyOS/OpenHarmony app crashes at the ArkTS/JS layer produce dense faultlogger logs that are hard to interpret, especially when release builds are obfuscated. This Skill turns those raw logs into an evidence-based root cause report with concrete fix suggestions. ## Core Features & Use Cases - Structured crash analysis: Extracts Reason, Error name, Error message, Error code, and Stacktrace fields, then matches them against a three-level JSError fault mode library (TypeError, ReferenceError, OutOfMemoryError, and more). - SourceMap symbolication: Uses the bundled cross-platform hstack tool to deobfuscate release/minified stack traces with sourceMaps.json and nameCache.json, restoring original source file, line, and column positions. - OOM snapshot handoff: When a crash is confirmed as OutOfMemoryError and the user provides rawheap or heapsnapshot files, it automatically chains into the jsleak-analysis Skill to locate suspected leak objects. - Use Case: A developer pastes a faultlogger log showing "TypeError: Cannot read property of undefined" after their app crashes on launch; the Skill identifies the responsible application stack frame, matches the fault pattern, and outputs a full analysis report with repair recommendations. ## Quick Start Ask the AI to analyze your HarmonyOS JS Crash log file with this skill, for example: "Use hmos-jscrash-analysis to analyze this jscrash faultlogger log and tell me the root cause."

Frequently Asked Questions about hmos-jscrash-analysis

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

FAQPage Schema
How do I analyze a HarmonyOS JS Crash faultlogger log?

Provide the faultlogger log file or paste its contents, and the Skill extracts Reason, Error name, Error message, Error code, and Stacktrace fields. It then classifies the fault type, matches it against the JSError fault mode library, and outputs a root cause report with fix suggestions.

How to deobfuscate HarmonyOS release crash stack traces with SourceMap?

Provide the sourceMaps.json from the same build version as the crashed app, plus nameCache.json if name obfuscation was enabled. The Skill runs the bundled hstack tool to restore original source files, line numbers, and method names before continuing root cause analysis.

Does this skill handle native C++ crashes or freeze logs?

No. It explicitly excludes cppcrash and freeze logs, and native/C++ layer crashes without JS or ArkTS error fields. Those cases should be handled by a native crash analysis skill instead.

What happens when a JS Crash is caused by OutOfMemoryError?

If the log confirms OutOfMemoryError and you also provide a rawheap or heapsnapshot file, the Skill automatically invokes the jsleak-analysis Skill to identify suspected leak objects, retained sizes, and strong reference chains related to the OOM.

Can JS Crash analysis work without SourceMap files?

Yes, it falls back to raw stack analysis using application paths and line numbers in the log, but marks the result as unsymbolicated with reduced confidence. The first recommendation will be to supply the matching version's sourceMaps.json for re-analysis.