lua skills lists the skills in lua.skill.yaml and on the server, makes a pushed skill version live in production, and deletes skills. deploy and delete change what the agent can do for every end user as soon as they succeed.
Verified against lua-cli 3.33.0.
Synopsis
Description
The first argument is an environment or an action. With no arguments the command asks for an environment and opens a menu. An action given without an environment runs against production and never prompts; that is the form for scripts and coding agents.view lists every skill in lua.skill.yaml with its ID, whether a version is deployed, and when. lua skills sandbox view prints one line per local skill (📦 <name> (<skillId>)) and exits. Any other sandbox form opens a menu that only refreshes the list and points you to lua compile and lua push skill.
lua skills production opens the production menu. An action after production is validated but does not skip the menu, so lua skills production view still prompts and fails under --ci. Use lua skills view.
versions does not list skill versions. Per-primitive history is managed by agent versions, so it prints a pointer to lua version list.
deploy makes one pushed version of the skill live from the agent’s next turn. It is the same operation as lua deploy skill --name <name> --set-version <ver> --force; lua deploy additionally records the deployed version in lua.skill.yaml. Neither creates an agent version, so the next lua version promote resets the skill to the version pinned in the promoted agent version; for a durable change, or when a change touches more than one primitive, run lua version create and lua version promote (see Release an agent). Non-interactive deploy runs without a confirmation prompt.
delete removes the skill from the server. A skill that has pushed versions is deactivated instead of deleted and stays in lua.skill.yaml until you remove it. delete also resolves skills that exist only on the server.
Every form needs a project directory (lua.skill.yaml with an agentId) and a credential; see lua auth.
Arguments
Accepted spellings:
staging, stage, sb → sandbox; prod, prd, live → production; show, info → view; list-versions, history → versions; publish → deploy; rm, remove, del → delete. Anything else exits 2 with the valid values.
Options
Examples
List the production skills and whether each is deployed.Output
lua.skill.yaml, one per line.
Output
Output
Exit codes
The full table, including the error line format, is in Errors and exit codes.
See also
lua deploy— the same deploy with the agent version reportedlua push— push a skill versionlua version— agent versions, promote, and rollbacklua production— production summary including skill versions- Release an agent