# harmony-next

A skill for HarmonyOS NEXT: an offline ArkTS, ArkUI and NDK reference plus scripts that automate DevEco Studio and the emulator.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 367
- Author: linhay
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/linhay/harmony-next.skills/tree/HEAD/harmony-next/SKILL.md
- Updated: 2026-09-20
- HTML: https://affpapa.org/en/nevibecode/skills/harmony-next

## What it does

The skill answers HarmonyOS NEXT questions without a network call. It ships an offline snapshot of the API 12–23 reference, with API 26 declaration pages under `references/JsEtsAPIReference/api26/`. A request gets classified first, then only the Markdown files needed for that answer are opened, which keeps context small.

Alongside the reference there are scripts for local automation: `commandline_tools_manager.py` installs and validates the Command Line Tools, `hvd_manager.py` lists and launches DevEco HVD instances, `device_evidence_bundle.py` pulls bounded logs and screenshots over hdc, and `device_ui_action.py` runs a single UI action with before-and-after evidence. Executable paths hang off `HARMONY_NEXT_SKILL_DIR`, the directory holding `SKILL.md`.

The bundled reference is a snapshot, not live docs. For anything about the newest API, the author points to GitHub Releases and Huawei online documentation. And if a script needs a Command Line Tools archive while you only have the Huawei download page URL, it returns a blocked result and asks for a direct link or a local file — worth lining that archive up before you start.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add linhay/harmony-next.skills --skill harmony-next -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/harmony-next/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/harmony-next/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add linhay/harmony-next.skills --skill harmony-next -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/harmony-next/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add linhay/harmony-next.skills --skill harmony-next -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/harmony-next/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install linhay/harmony-next.skills harmony-next
```

2. **Manually: put the files in place**
- File: `.github/skills/harmony-next/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add linhay/harmony-next.skills --skill harmony-next -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/linhay/harmony-next.skills --path harmony-next
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/harmony-next/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add linhay/harmony-next.skills --skill harmony-next -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/linhay/harmony-next.skills/tree/HEAD/harmony-next/SKILL.md

## When to use it
- look up an ArkTS method signature without opening a browser
- bring up and diagnose a HarmonyOS emulator instance
- collect device logs and screenshots over hdc
- run one UI action and capture state before and after
- trace WebView DevTools forwarding and CDP calls

## Example prompts
- Find the @ohos.app.ability.Want signature in the reference and show an example
- Start an HVD emulator and run the doctor check
- Capture device logs and walk through WebView DevTools forwarding

## Similar
- [harmonyos-app](https://affpapa.org/en/nevibecode/skills/harmonyos-app.md) — skill · 491 installs
- [harmonyos-device-automation](https://affpapa.org/en/nevibecode/skills/harmonyos-device-automation.md) — skill · 2400 installs
- [arkts-syntax-assistant](https://affpapa.org/en/nevibecode/skills/arkts-syntax-assistant.md) — skill · 824 installs
- [google-mobile-ads-android-migrate-to-next-gen](https://affpapa.org/en/nevibecode/skills/google-mobile-ads-android-migrate-to-next-gen.md) — skill · 5969 installs
- [color-theory-palette-harmony-expert](https://affpapa.org/en/nevibecode/skills/color-theory-palette-harmony-expert.md) — skill · 430 installs
- [firebase-crashlytics](https://affpapa.org/en/nevibecode/skills/firebase-crashlytics.md) — skill · 131700 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md