System Documentation

What problem does it solve?

Debugging HarmonyOS ArkWeb (webview) apps is hard because you need reliable device connectivity, DevTools port forwarding, and a way to inspect console, network, and web elements.

Core Features & Use Cases

  • ArkWeb DevTools Debugging: Start a debugging session for an ArkWeb app and connect Chrome DevTools via the Chrome DevTools Protocol.
  • Automatic Device & Socket Setup: Detect the HarmonyOS project configuration (package name), connect to the device, find the webview devtools socket, and create localhost port forwarding.
  • Inspection & Troubleshooting: Inspect webview elements, console output, and network activity, and troubleshoot common issues like missing sockets or failed DevTools connections.

Example: when a webview page fails to load or logs errors, use this skill to connect DevTools, inspect the failing DOM/network calls, and iterate quickly until the issue is resolved.

Quick Start

Start an ArkWeb debugging session from your HarmonyOS project folder by running $SKILL_DIR/scripts/start-debug.sh.

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: arkweb-app-debug
Download link: https://github.com/openharmonyinsight/openharmony-skills/archive/main.zip#arkweb-app-debug

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.