oh-skillhub

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

This package is designed to run through npx:

npx @openharmonyinsight/oh-skillhub list
npx @openharmonyinsight/oh-skillhub install --domain arkui --agent codex
npx @openharmonyinsight/oh-skillhub install --domain arkui --agent all --scope user

Current Capabilities

• List bundled OpenHarmony skills by domain or stage.
• Resolve profile/domain selections such as arkui, app-dev, cicd, testing, and security.
• Install skills into Codex, Claude Code, and OpenCode target directories.
• Support --agent codex|claude|opencode|all.
• Support --scope user|project.
• Support --dry-run install plans.
• Keep anonymous telemetry events in a local retry queue.

Commands

oh-skillhub list [--domain <name>] [--stage <name>]
oh-skillhub install [skill...] [--domain <name>] [--preset <name>] [--agent codex|claude|opencode|all]
oh-skillhub doctor [--agent codex|claude|opencode|all]
oh-skillhub telemetry status

Agent Targets

| Agent | User scope | Project scope | | --- | --- | --- | | Codex | $CODEX_HOME/skills, otherwise ~/.codex/skills | <cwd>/.codex/skills | | Claude Code | ~/.claude/skills | <cwd>/.claude/skills | | OpenCode | ~/.config/opencode/skill | <cwd>/.opencode/skill |

Examples:

npx @openharmonyinsight/oh-skillhub install --domain arkui --agent claude --scope user
npx @openharmonyinsight/oh-skillhub install --preset app-dev --agent opencode --scope project
npx @openharmonyinsight/oh-skillhub install --domain security --agent all --dry-run

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 @openharmonyinsight/oh-skillhub install --domain arkui --no-telemetry

Inspect status:

npx @openharmonyinsight/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.