HarmonyOS AI Skill
HarmonyOS NEXT knowledge for agents: ArkTS, ArkUI, the Stage model and 60-plus Kits, one source built for 11 AI tools
- 291 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- Reference material: the skill runs nothing and makes no network calls, it only adds knowledge to the agent's context
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/harmonyos-ai-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Reference material: the skill runs nothing and makes no network calls, it only adds knowledge to the agent's context
This is third-party code. Review the repository files before installing.
What it does
HarmonyOS AI Skill is a knowledge base for developing on HarmonyOS NEXT with AI agents. The main `SKILL.md` runs to 4475 lines and 245 sections with more than 105 code examples, next to `references/` guides on versions, API 26 migration, NDK and Node-API. The author starts from the fact that model training data has almost no ArkTS: without the reference an agent proposes React components and edits `module.json5` as if it were `package.json`. The content covers strict ArkTS syntax, the Stage model (UIAbility, WindowStage, `module.json5`), ArkUI components, V1 and V2 state (`@State`, `@Local`, `@Param`, PersistenceV2), Navigation and NavPathStack, lists with LazyForEach, more than 60 Kits (camera, payment, push, maps, Core Vision), data storage, networking, TaskPool and Worker, permissions, multi-device adaptation, ArkGuard and arkxtest tests. Official materials were checked on 24 October 2026, and new projects target HarmonyOS 7 and API 26. From one source, the `dist/` build produces configurations for Claude Code (a skill with examples, recipes and eval cases), Cursor (`.cursorrules` and `harmonyos.mdc`), GitHub Copilot, Gemini CLI, Cline, Continue, Windsurf, the AGENTS.md format and a system prompt.
Who it is for. Developers building HarmonyOS NEXT apps who write ArkTS and ArkUI with Claude Code, Cursor, Copilot and other agents.
Good fit when
- The agent returns React Native or Android instead of ArkUI and mixes up `module.json5` with `package.json`
- A project moves from Router to Navigation and NavPathStack or from old V1 decorators to V2
- You wire a Kit such as camera, payment or push and need the import, permissions and call order: permissions follow check, request, then a trip to settings
- ArkTS code is under review, and the Claude Code package ships `review-arkts-code` and `debug-build-error` recipes
- The app must run on a phone, a tablet and a foldable: the base describes xs–xl breakpoints, GridRow and GridCol
Not a fit when
- You develop for Android or iOS: the knowledge applies to HarmonyOS NEXT only
- You need emulator launching and network traffic analysis: the package is a reference with no tools for that
- The project sits on pre-NEXT HarmonyOS versions: the reference targets API 22–26
- You need information newer than October 2026: the official materials were checked on 24 October
Example request
Rewrite the screen from Router to Navigation and NavPathStack, use V2 decorators and show which module.json5 entries the camera needs.Limitations
- Knowledge was checked against official Huawei materials on 24 October 2026, and later platform changes are not in the package.
- Cursor, Copilot and other tools without native skills get one generated version with the references bundled in, and nothing loads on demand there.
- A skill link on Windows needs developer mode and PowerShell, otherwise the folder is copied with `Copy-Item` and updated by hand.
- The main documentation is in Chinese, and an English version lives in `README_EN.md`.
How to disable. Delete the link or folder `~/.claude/skills/harmonyos-development` and restart Claude Code. In other tools remove the files you added: `.cursorrules`, `harmonyos.mdc`, `copilot-instructions.md`, `GEMINI.md` or `AGENTS.md`.
FAQ
How do I install HarmonyOS AI Skill in Claude Code?
Clone the repository into `~/src/harmonyos-ai-skill` and create a link: `ln -s ~/src/harmonyos-ai-skill/harmonyos-development ~/.claude/skills/harmonyos-development`. After restarting Claude Code, ask it which skills are available.
Does the skill work in Cursor and Copilot?
Yes, `dist/` holds ready files for them: `.cursorrules` and `harmonyos.mdc` for Cursor, `copilot-instructions.md` for Copilot. They are built from the same source and bundle the references.
What changes in the agent's answers after installing?
The agent answers in ArkUI terms: state through `@State` and `@ObjectLink`, routing through Navigation, HTTP requests through `http.createHttp()` from NetworkKit. Without the skill it suggests useState, react-router and axios.
Which versions does the skill target?
New projects target HarmonyOS 7 and API 26 Release, and existing API 24 projects stay compatible. The README lists the ArkTS range as API 22–26.
How do I install it on Windows?
In PowerShell 7 enable developer mode and create a link with `New-Item -ItemType SymbolicLink` to the `harmonyos-development` folder in `$HOME\.claude\skills`. A fallback is described in the README.
Discussion
No questions or reviews yet.
Related
SkillsAn offline HarmonyOS NEXT reference for agents: API 12–26, ArkTS and ArkUI, DevEco Studio, the emulator and traffic capture.
21 skills for Android and KMP in Claude Code, Codex and Copilot CLI: Compose, coroutines, Flow, networking, storage, Gradle
Official set of 30 skills from the Android team: Jetpack Compose, AGP 9 upgrade, R8, Perfetto profiling, Navigation 3, CameraX, Google Play policies
Awesome Android Agent Skills
awesome-android-agent-skills
Skills for modern Android development for Copilot, Claude, Gemini and Cursor: Kotlin, Jetpack Compose, architecture, Hilt, Room
A set of skills for iOS 26+, Swift 6.3 and SwiftUI that gives the agent knowledge of modern Apple frameworks
The a2ui-generation skill teaches an agent to build A2UI v0.9 cards and pages for native iOS, Android and HarmonyOS apps.
README in short
The README is in Chinese. It shows a Claude Code quick start for macOS, Linux and Windows, a table of agent answers before and after installation and a map of the package's knowledge. Then come instructions for the other AI tools, a check that the skill was picked up and the list of supported agents.
README badge
Original SKILL.md
--- name: harmonyos-development description: > Use when developing, reviewing, debugging, or migrating HarmonyOS NEXT native apps with ArkTS, ArkUI, DevEco Studio, DevEco Code, DevEco CLI, Agent Framework Kit, Stage model, UIAbility, .ets, module.json5, oh-package.json5, HAP/HSP/HAR, API 22-24, API 26 Release, HarmonyOS 6.1, HarmonyOS 6.1.1 Release, HarmonyOS 7, HarmonyOS 26.0.0 Release, NDK/Node-API, state management decorators, Navigation/NavPathStack, ArkTS concurrency, permissions, persistence, networking, media, Camera Kit, Scan Kit, Map Kit, Push Kit, Payment Kit, App Linking, Share Kit, Weather Service Kit, ArkGuard, APIAVAILABLE, ContainerReader, jsLeakWatcher, Linux CI, testing, performance, or common 鸿蒙开发 workflows. --- # HarmonyOS (鸿蒙) Development Covers HarmonyOS 7 / API 26.0.0 Release and existing HarmonyOS 6.1 / 6.1.1 (API 23 / 24) native apps. Primary language is **ArkTS** and the primary UI framework is **ArkUI**. For new projects use the API 26 Release toolchain; for existing projects inspect SDK settings before changing them. Set `compatibleSdkVersion` from device coverage and protect newer calls on older devices. Read `references/platform-baseline.md` for SDK selection, `references/api26-release.md` for migration, and `references/ndk-napi.md` for C/C++ bindings, threads, async work, and ownership. Other task-specific references are routed through `references/README.md`. ## Platform snapshot | Item | Value | |---|---| | OS | **HarmonyOS 7 / API 26.0.0 Release** (officially listed in August 2026). Existing **HarmonyOS 6.1 / 6.1.1**, API 23 / 24 projects remain supported | | Language | **ArkTS** (primary), **Cangjie** (beta), C/C++ via NAPI | | UI framework | **ArkUI** declarative (ArkUI-X for cross-platform) | | Compiler | **ArkCompiler** — AOT to native machine code; LiteActor concurrency | | Package manager | **ohpm** — `oh-package.json5`; registry at DevEco Service (OHPM Central) | | IDE | Verified Release pairing: **DevEco Studio 26.0.0.821**, SDK **26.0.0 Release**. Check official updates for later IDE patches | | App model | **Stage model** (FA model is legacy — don't use in new apps) | | Packaging | HAP (entry/feature), HSP (shared package), HAR (static archive), atomic .app | | Recommended API | **API 26 Release for new projects; preserve existing project settings and choose compatible SDK from device coverage** | | Sample catalog | https://developer.huawei.com/consumer/cn/samples/ | **Release timeline (recent):** - HarmonyOS 6.0.1(21) — 2025/11/25 (initial stable with Mate 80 series) - HarmonyOS 6.0.2(22) — 2026/01/23 (incremental update) - HarmonyOS 6.0.0.328 Pollen Beta(23) — 2026/02/28 (closed beta, 25 models) - HarmonyOS 6.1(23) — 2026/04/20 (stable general release) - HarmonyOS 6.1.1(24) Beta 1 — 2026/04/30 (developer beta) - HarmonyOS 6.1.1(24) Release — 2026/05/26 (API 24 Release; DevEco Studio 6.1.1.280) - HarmonyOS 7 / 26.0.0 Beta1 — 2026/06/12 (API 26 developer preview; DevEco Studio 26.0.0.461) - HarmonyOS 7 / 26.0.0 Release — 2026/08 (official August bulletin; supersedes Beta1/Beta2)