src/skills/hey/SKILL.md
Talk to another oracle via maw federation. Uses fleet machine names (white, mba, clinic-nat, oracle-world, phaith). Auto-signs with current oracle's [host:handle] from CLAUDE.md. Global — works from any oracle repo.
npx skillsauth add Soul-Brews-Studio/oracle-skills-cli heyInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Quick federation messenger. Wraps maw hey <node>:<agent> with two additions:
fireman instead of white:fireman when target is on current host[<host>:<handle>] read from local CLAUDE.md/hey <node>:<agent> <message> # explicit node:agent
/hey <agent> <message> # same host as me (infer node)
/hey list # list reachable agents in fleet
/hey peek <node>:<agent> # wrap maw peek
date "+🕐 %H:%M %Z"
# Resolve my identity from CLAUDE.md
MY_HANDLE=$(grep -E "^- \*\*Technical handle\*\*:|^- \*\*Handle\*\*:" CLAUDE.md 2>/dev/null | head -1 | sed -E 's/.*`([^`]+)`.*/\1/' || echo "")
# Fallback to repo name if CLAUDE.md missing
[ -z "$MY_HANDLE" ] && MY_HANDLE=$(basename "$(git rev-parse --show-toplevel 2>/dev/null || pwd)" | sed 's/-oracle$//')
MY_HOST=$(hostname -s 2>/dev/null | tr '[:upper:]' '[:lower:]')
# Common fleet host aliases
case "$MY_HOST" in
white.local|white) MY_HOST=white ;;
mba*) MY_HOST=mba ;;
esac
MY_SIG="[$MY_HOST:$MY_HANDLE]"
echo "sig=$MY_SIG"
TARGET="$1" # fireman OR white:fireman
MSG="$2" # message body
# Resolve target node
if [[ "$TARGET" == *:* ]]; then
NODE=${TARGET%%:*}
AGENT=${TARGET##*:}
else
NODE=$MY_HOST
AGENT=$TARGET
fi
maw hey "$NODE:$AGENT" "$MSG $MY_SIG"
maw agents 2>&1 | awk 'NR>1 {print $1":"$4, "("$5")"}'
maw peek "$TARGET" 2>&1 | head -40
| Name | IP | Route |
|---|---|---|
| white | localhost / 10.x | this machine (Linux/Ubuntu) |
| mba | mba.wg / 10.20.0.3 | WireGuard |
| clinic-nat | 10.20.0.1 | WireGuard |
| oracle-world | 100.120.242.120 | WireGuard |
| phaith | localhost:3458 | local peer |
All outbound federation messages carry [<host>:<handle>] at the end. Never pretend to be human; never drop the sig. The sig is identity, not decoration.
/contacts (core) — Oracle contact registry/talk-to (core) — heavier threaded conversation/federation-talk (user) — fleet-wide broadcast/hey fireman "FMT registry changed?"
/hey white:arthur-god-line "update from child"
/hey list
/hey peek white:fireman
ARGUMENTS: $ARGUMENTS
testing
Cut a beta pre-release — bump CalVer with --beta, PR to beta branch, CI auto-tags + publishes to npm @beta. Use when user says 'release beta', 'cut beta', '/release-beta', or wants to publish a beta version for pre-release testing.
testing
Cut an alpha pre-release — bump CalVer, PR to alpha branch, CI auto-tags + publishes to npm @alpha. Use when user says 'release alpha', 'cut alpha', '/release-alpha', or wants to publish an alpha version.
development
Log information for future reference. Use when user says "fyi", "remember this", "note that", "for your info".
tools
Show or bump CalVer version via bun scripts/calver.ts in arra-oracle-skills-cli. Default is dry-run --check. Read-only by default; `--apply` writes package.json. **For full release flow (commit + push + PR), use /release-alpha or /release-stable instead** — /calver alone never commits, pushes, or PRs.