harhub

Harhub

Harhub is a workspace for managing reusable Agent Skills.

It helps teams upload, validate, preview, and organize Skill packages so coding agents can use a shared set of team-approved capabilities instead of scattered local files.

Harhub currently focuses on Agent Skills as the first supported asset type. MCPs, rules, and other agent assets are planned, but the current product surface is intentionally Skills-first.

What You Can Do

• Upload Skill zip packages.
• Validate packages against the Agent Skills SKILL.md format.
• Search and browse Skills in a workspace.
• Preview Skill metadata and package files.
• Manage Skills from the web UI or CLI.
• Run Harhub locally with S3-compatible object storage and optional Postgres persistence.

Agent Skills

Harhub manages the open Agent Skills format documented at agentskills.io. A Skill package is a directory or zip containing SKILL.md.

code-review/
  SKILL.md
  references/
  scripts/
  assets/

Harhub does not define a competing Skill format. It stores package files and the runtime state needed to manage them in a workspace.

Quick Start

Try the hosted demo:

https://harhub.rcpd.cc

Run Harhub locally:

npm install
npm run build
npm run start

Then open:

http://127.0.0.1:5176/skills

Demo account:

admin@harhub.local
harhub

For local development:

npm run dev

Fixed local ports:

• Web: http://127.0.0.1:5176
• API: http://127.0.0.1:3310

To start the local cloud-style stack with object storage:

npm run dev:cloud

CLI

Install the CLI from a checkout:

npm install
npm run build
npm install -g .

Configure your Harhub target:

export HARHUB_WORKSPACE_ID=ws_demo
export HARHUB_TOKEN=<access-token>

The CLI defaults to the hosted demo at https://harhub.rcpd.cc. Set HARHUB_URL or pass --url when targeting a local or self-hosted instance:

export HARHUB_URL=http://127.0.0.1:3310

Scan the current directory and choose which discovered Skills to upload:

harhub skills upload

Scan a specific directory:

harhub skills upload /path/to/repo

Upload every valid discovered Skill without the selector:

harhub skills upload /path/to/repo --all

Useful commands:

harhub assets list
harhub assets show <id|name|slug>
harhub skills scan [paths...]
harhub skills validate [paths...]
harhub skills upload [paths...]

Configuration

Skill uploads require S3-compatible object storage:

export HARHUB_S3_BUCKET=harhub-assets
export HARHUB_S3_REGION=us-east-1
export HARHUB_S3_ENDPOINT=http://127.0.0.1:9000
export HARHUB_S3_FORCE_PATH_STYLE=true

For persistent hosted or local deployments, configure Postgres:

export HARHUB_DATABASE_URL=postgres://user:password@host:5432/harhub

Without Postgres, Harhub falls back to local development state under .harhub/.

Learn More

Detailed documentation lives in docs/.

For Skill package details, see docs/06-skill-standard.md.