Skip to content

Write Personality and Skills

SOUL defines personality and behavioral stance. SKILL defines a bounded purpose and workflow.

Terminal window
genaug agent soul set support ./agents/support/SOUL.md --wait
genaug skill add ./skills/order-support/SKILL.md
genaug agent skill attach support order-support --wait

The CLI captures every visible UTF-8 regular file below the SKILL.md directory as one immutable release bundle. Hidden files are ignored, empty supporting placeholders are preserved, and symbolic links or nested SKILL.md entrypoints are rejected. Editing any supporting file changes the Candidate fingerprint; an open Candidate or Live Agent cannot rewrite it.

Inspect the compiled source:

Terminal window
genaug agent soul show support
genaug skill show order-support
genaug agent show support

Multiple Agents may use different SOUL and SKILL assets. A shared Skill does not widen either Agent’s capabilities, memory, limits, or connections.

Terminal window
genaug agent test support --user customer_123 --json
genaug run show <run-id>

Do not put credentials, private user data, or mutable provider state in source assets.