@elisym/husk

@elisym/husk

The husk CLI - HUSK, the HTTP Universal Skill Kernel. Turn a folder of agent skills into a working HTTP backend with one long-lived Bun process. No SDK, no rewrite: write a script in any language, and HUSK publishes it.

bun add -g @elisym/husk

Quick start

husk init                 # create ./skills with a starter skill
husk serve                # serve every skill over HTTP on :3000
curl -X POST localhost:3000/skills/hello --data 'world'

Commands

Command	Description
husk serve [dir]	Serve a folder of skills over HTTP. --watch hot-reloads, --port, --host, --concurrency, --cors, --name.
husk list [dir]	List discovered skills (--json for machine output).
husk call <name>	Invoke a skill locally without HTTP. -i/--input (- = stdin, @file = file), -f/--file, -o/--out, -d/--dir.
husk new <name>	Scaffold a skill. -l/--lang bash|python|ts, -d/--dir.
husk init [dir]	Create a project with a ./skills folder and a starter skill.
husk build [dir] --docker	Emit a Dockerfile so the same skills run in a container.

A skill is a folder

# skills/uppercase/SKILL.md
---
name: Uppercase
description: Send any text, get it back in upper case.
run: ./upper.sh
---

# skills/uppercase/upper.sh
#!/bin/sh
exec tr 'a-z' 'A-Z'

That is the whole skill. See the HUSK guide for the manifest reference, the kernel I/O contract, and deployment patterns.

Requires Bun (the server uses Bun.serve). The engine itself lives in @elisym/husk-core.

MIT licensed, by elisym labs.