Hero Skills

Claude Code skills and the lab build orchestrator for the Hero stack.

---

What is lab?

lab is a Cargo-native Hero build orchestrator. It discovers binary targets, skips unchanged ones via fingerprinting, copies built binaries to ~/hero/bin, manages Forgejo repos, syncs secrets via hero_proc, and runs AI agents.

lab [flags] — build binaries in the current repo
lab build [REPO] [flags] — find/clone a named repo then build it
lab user init — install Rust + nushell, write hero_cfg.toml, configure shell
lab install core — full install (AI tools, hero_proc, ...)
lab repo <verb> — Forgejo repo management
lab secrets <verb> — hero_proc / file-based secrets management
lab skills edit|sync — manage Claude Code skills
lab agent 'instruction' — run an AI agent instruction

---

Quick start (fresh machine)

Bring up the core Hero stack (hero_proc → mycelium → hero_router) from scratch:

1. curl -sSfL https://forge.ourworld.tf/lhumina_code/hero_skills/raw/branch/main/scripts/lab_install.sh | bash — install lab into ~/hero/bin.
2. export FORGE_TOKEN=<token> — set your Forge access token (used for repo clones + git deps).
3. lab user init — install Rust + nushell, write hero_cfg.toml, configure the shell.
4. lab install core — install base tools, sccache, Rust, and hero_proc.
5. lab service infra --start --build — build + start hero_proc → mycelium → hero_router, in order.

infra is exactly those three services; add --release for optimized binaries.

---

Getting lab

Install (download or build from source)

curl -sSfL https://forge.ourworld.tf/lhumina_code/hero_skills/raw/branch/main/scripts/lab_install.sh | bash

lab_install.sh detects your platform (macOS/Linux, arm64/x86_64), downloads the pre-built binary from Forgejo into ~/hero/bin/lab, and falls back to building from source if no binary is available.

---

First-time setup

After installing lab:

export PATH="$HOME/hero/bin:$PATH"
lab user init # install Rust + nushell, configure shell, prompt for FORGE_TOKEN
lab install core # install AI tools, hero_proc, etc.

lab user init generates:

• ~/hero/cfg/init.sh — bash environment (PATH_ROOT, CARGO_HOME, sccache, …)
• ~/.config/nushell/env.nu — nushell equivalent, sets NU_LIB_DIRS and loads Hero modules
• ~/.config/nushell/config.nu — sources hero_loader.nu and config_user.nu

---

Building and uploading a release

lab build --upload --platforms allbase -v

Builds for macos-arm64, linux-musl-arm64, linux-musl-x86_64 and uploads to Forgejo.

---

Getting a FORGE_TOKEN

Required for lab repo and lab secrets:

1. Go to https://forge.ourworld.tf/user/settings/applications
2. Generate a token with read:repository + write:repository scopes
3. Set FORGE_TOKEN in your environment (or let lab user init prompt for it)