arkui-api-design

Design and review ArkUI component APIs against OpenHarmony TypeScript/JavaScript standards.

31|6|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/openharmonyinsight/openharmony-skills --skill arkui-api-design-openharmonyinsight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arkui-api-design
Source: https://github.com/openharmonyinsight/openharmony-skills/tree/main/skills/arkui-api-design
Command: npx skills add https://github.com/openharmonyinsight/openharmony-skills --skill arkui-api-design-openharmonyinsight

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the difficulty of defining correct ArkUI component APIs that must stay consistent across static and dynamic interface layers, including complete JSDoc, correct typing (Resource vs ResourceStr), and successful SDK compilation/verification.

Core Features & Use Cases

  • Static/Dynamic API synchronization: Ensures any added/modified/deprecated component property is reflected consistently in the correct static and dynamic API files.
  • ArkUI API design with strict JSDoc: Produces review-ready JSDoc using OpenHarmony conventions, including required tags and clear undefined/null behavior.
  • SDK build and output verification guidance: Guides the user to compile the SDK and verify that generated outputs export the new or updated APIs.

Quick Start

Ask the skill to design a new Button property and update both the static and dynamic APIs, then verify the SDK output contains the changes.

Frequently Asked Questions about arkui-api-design

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

FAQPage Schema
How do I ensure ArkUI component APIs stay consistent across static and dynamic interface layers?

To design an ArkUI component API, you add component properties, create Modifier methods, deprecate APIs with migration guidance, enforce correct JSDoc tag structure, ensure consistent Resource handling rules, and verify changes through SDK compilation output.

How do I deprecate an ArkUI API with proper migration guidance?

To deprecate an ArkUI API with migration guidance, you apply OpenHarmony TypeScript coding standards to mark the API deprecated, update the JSDoc tags with clear undefined/null behavior, and synchronize the changes across static and dynamic API files.

When should I use Resource vs ResourceStr types in OpenHarmony API design?

Yes, you can verify new component properties in the SDK build by following a build-and-verify workflow using SDK compilation output paths, which ensures the generated outputs export the new or updated ArkUI APIs successfully.

What is the correct JSDoc tag structure for OpenHarmony ArkUI component APIs?

To deprecate an ArkUI API with proper migration guidance, you apply OpenHarmony TypeScript coding standards to mark the API deprecated, update the JSDoc tags with clear undefined/null behavior, and synchronize the changes across static and dynamic API files.

Does the SDK build verification process confirm that new ArkUI component properties are exported?

When should I use Resource versus ResourceStr types in OpenHarmony ArkUI API design? You must enforce correct typing rules for Resource versus ResourceStr during OpenHarmony API design to ensure strict type signatures, handling component properties consistently and matching the expected OpenHarmony coding standards.