oh-skillhub

OpenHarmony Skills unified installer for Codex, Claude Code, and OpenCode.

This package is designed to run through npx:

npx oh-skillhub@latest
npx oh-skillhub list
npx oh-skillhub install --domain arkui --agent codex
npx oh-skillhub install --domain arkui --agent all --scope user
npx oh-skillhub clean --agent claude --scope user --dry-run

Running without arguments starts a TUI selector. Choose the install target first (Codex, Claude, OpenCode, or All), then choose the skill groups to install.

In an interactive terminal:

• Use Up / Down or j / k to move.
• Press Space to select or unselect a group.
• Press Enter to install selected groups.

When input is piped or the terminal does not support raw key input, enter numbers separated by spaces:

printf "1\n3 9\n" | npx oh-skillhub@latest

Current Capabilities

• List bundled OpenHarmony skills by domain or stage.
• Resolve profile/domain selections such as arkui, app-dev, cicd, testing, and security.
• Download the selected skill directories from the OpenHarmony skills release branch and install the full skill contents.
• Install skills into Codex, Claude Code, and OpenCode target directories.
• Support --agent codex|claude|opencode|all.
• Support interactive target selection for Codex, Claude, OpenCode, and All.
• Support --scope user|project.
• Support --dry-run install plans.
• Scan installed skills and clean selected skills with clean.
• Move cleaned skills to .oh-skillhub/trash by default, with --purge for permanent deletion.
• Run a TUI matching the skills/common/* and skills/domain/* repository layout.
• Keep anonymous telemetry events in a local retry queue.

The installer uses sparse Git checkout so it downloads only the selected skill directories instead of the whole repository.

Commands

oh-skillhub list [--domain <name>] [--stage <name>]
oh-skillhub install [skill...] [--domain <name>] [--preset <name>] [--agent codex|claude|opencode|all]
oh-skillhub clean [skill...] [--agent codex|claude|opencode|all] [--scope user|project] [--dry-run] [--purge]
oh-skillhub doctor [--agent codex|claude|opencode|all]
oh-skillhub telemetry status

Agent Targets

Examples:

npx oh-skillhub install --domain arkui --agent claude --scope user
npx oh-skillhub install --preset app-dev --agent opencode --scope project
npx oh-skillhub install --domain security --agent all --dry-run
npx oh-skillhub clean --agent claude --scope user --dry-run
npx oh-skillhub clean --agent claude --scope user ohos-test-capi-xts-generation

Telemetry

The CLI can enqueue anonymous installation events so a collector service can aggregate:

• installs per skill
• installs per domain
• installs per profile
• installs per target agent

The current implementation writes only to a local queue:

~/.cache/oh-skillhub/telemetry-queue.jsonl

Telemetry does not include usernames, email addresses, local target paths, repository contents, or skill contents.

Disable event creation for a command:

npx oh-skillhub install --domain arkui --no-telemetry

Inspect status:

npx oh-skillhub telemetry status

Development

Run tests:

npm test

Run the local CLI:

node bin/oh-skillhub.js list --domain arkui
node bin/oh-skillhub.js install --domain arkui --agent all --scope user --dry-run

First-Version Limits

• Uses a bundled manifest derived from the GitCode release branch examples.
• Does not yet refresh the remote GitCode manifest at runtime.
• Writes a generated SKILL.md from manifest metadata instead of downloading full remote skill directories.
• Telemetry collector upload is designed but not yet wired; events are queued locally.