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 --all-common --agent codex --scope user
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 an action first (Install skills or Clean installed skills). Install then asks for the target (Codex, Claude, OpenCode, or All) and skill groups. The first skill group is common / all, which installs every skill under skills/common. Clean asks for the target and installed skills to remove.

In an interactive terminal:

• Use Up / Down or j / k to move.
• Press Space to select or unselect items.
• Press Enter to confirm the current action.

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

printf "1\n1\n1\n" | npx oh-skillhub@latest
printf "1\n1\n4 10\n" | npx oh-skillhub@latest
printf "2\n2\n1\n\n" | npx oh-skillhub@latest

The old piped installer format is still accepted:

printf "1\n1\n" | npx oh-skillhub@latest
printf "1\n4 10\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.
• Install all common skills in one step with common / all in the TUI or --all-common in the CLI.
• 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.
• Show clean as a first-class option in the default TUI.
• 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.
• Refresh the skill catalog from the GitCode release branch at runtime, with cached and bundled fallback data.
• Keep anonymous telemetry events in a local retry queue.

The installer refreshes the catalog with a shallow Git read of the release branch. It then 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>] [--all-common] [--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 --all-common --agent codex --scope user
npx oh-skillhub install --all-common --agent all --scope user --dry-run
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

• list and direct install commands use the bundled manifest for fast startup; the no-argument TUI refreshes the catalog from GitCode at runtime.
• Runtime refresh requires git on the user's PATH. If refresh fails, the TUI falls back to the cached catalog and then to the bundled manifest.
• Telemetry collector upload is designed but not yet wired; events are queued locally.