harmony-components

Match user feature intent to HarmonyOS components and guide installation.

6|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/xblLab/harmony-components-skill --skill harmony-components
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harmony-components
Source: https://github.com/xblLab/harmony-components-skill/tree/main
Command: npx skills add https://github.com/xblLab/harmony-components-skill --skill harmony-components

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nodejs, npm, curl, unzip, ohpm, json5, child_process, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the problem of quickly finding the right HarmonyOS component for a specific feature (e.g., maps, charts, forms, navigation) and guiding the user to install it correctly in a HarmonyOS project without manually searching and wiring everything.

Core Features & Use Cases

  • Component discovery via lightweight index: Matches the user’s request against an offline references index (top candidate components) to reduce time-to-solution.
  • Detail loading per component id: Reads the selected component’s detailed README from references to explain what it does and how to integrate it.
  • Installation guidance with a unified script workflow: After confirmation, instructs the user to run the common installer script with component_id and (optionally) a target project path.

Use Case Example: A developer asks for a “map + location pin picker” feature; the Skill identifies the best matching component candidates, presents details, and then provides the exact install command to place the component under components/ and update dependencies before running ohpm install.

Quick Start

Ask: “I need a HarmonyOS map component that supports selecting/placing a location pin—what options do you recommend and how do I install the best one into my project?”

Frequently Asked Questions about harmony-components

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

FAQPage Schema
How do I find and install HarmonyOS components for specific features like maps or charts?

To find and install HarmonyOS components, match your feature intent against a local component index to identify top candidates, read their detailed documentation, and execute scripts/install.sh with the component_id followed by ohpm install.

What's the best way to integrate official and community UI components into a HarmonyOS project?

The best way to integrate HarmonyOS UI components is using a unified installer script that places the component under components/ and updates dependencies, requiring you to specify the component_id and an optional project root path before running ohpm install.

Can I use ohpm to automate component discovery and installation in ArkTS?

Yes, you can automate component discovery and installation in ArkTS by matching feature requests against an offline references index, loading component-specific README files, and guiding the execution of install scripts before running ohpm.

Do I need Node.js and npm to set up the HarmonyOS component workflow?

Yes, you need Node.js and npm along with curl, unzip, and ohpm installed in your environment to execute the installation scripts and manage dependencies for HarmonyOS component integration.

Why does my HarmonyOS component installation fail after selecting a package from the index?

HarmonyOS component installation may fail if the scripts/install.sh is not executed with the correct component_id or if the project root path is invalid, preventing ohpm install from properly updating dependencies.

How does offline component discovery work for HarmonyOS development workflows?

Offline component discovery works by reading references/index.json to match user feature requests against top candidate components, then loading references/components/<id>/README.md to provide detailed integration instructions without manual searching.