Skip to Content
CLI referencecapability

hiveloom capability

Skills are markdown documents (with frontmatter) that extend an agent’s behaviour. capability attaches them to a specific agent and manages the binding.

Synopsis

hiveloom capability [GLOBAL FLAGS] <COMMAND>

Global flags

FlagDefaultDescription
--tenant <TENANT>defaultTenant slug.
--endpoint <URL>API endpoint.
--token <TOKEN>Bearer token.
--jsonJSON output.

Subcommands

SubcommandPurpose
addAttach a skill file to an agent.
listList capabilities attached to an agent.
showShow one capability’s metadata + body.
editEdit a capability in $EDITOR.
removeDetach a capability from an agent.

Examples

Attach a markdown skill file:

hiveloom capability add \ --agent pirate \ --file ./skills/pirate-voice.md

List attached skills:

hiveloom capability list --agent pirate

Inspect one:

hiveloom capability show cap_abc123 --agent pirate

Edit live (bumps the agent’s version on save):

hiveloom capability edit cap_abc123 --agent pirate

Detach without deleting the source file:

hiveloom capability remove cap_abc123 --agent pirate

Skill file format

See Skills reference for frontmatter fields and the on-disk layout. Three worked examples (persona, tool-calling, retrieval-style knowledge injection) are at Skill examples.