lua.skill.yaml

​

Example

agent:
  agentId: agent_abc123
  orgId: org_abc123
skills:
  - name: tickets
    skillId: skill_abc123
    version: 1.0.3
webhooks:
  - name: ticket-status-webhook
    version: 1.0.3
    webhookId: webhook_abc123
jobs: []
preprocessors:
  - name: pii-redaction
    preprocessorId: preprocessor_abc123
    version: 1.0.3
postprocessors:
  - name: ticket-footer
    postprocessorId: postprocessor_abc123
    version: 1.0.3
mcpServers: []
backup:
  activeVersion: 3
  lastHash: 8198f4f371f01a496147ec72b4cfcbc208aa0242803167d56c20323117d1af47
  lastPushedAt: '2026-09-12T12:49:51.474Z'
workflows: []

​

Keys

​

Writes by the CLI

• lua compile adds a row for every primitive reachable from the LuaAgent in src/index.ts, with version: 1.0.0 and an empty id for a new one, and removes rows whose primitive is no longer in the code, as long as at least one primitive of that kind remains. It never writes server ids and sends nothing to the server.
• lua push and lua sync reconcile with the server: they register primitives that have no id yet and write the returned id, link a row whose name already exists on the server, set version to the server’s active version when the two differ, and add a row for any primitive that exists on the server but not in your code, with a Found … on server not in your local code message.
• A push then writes the version it pushed; lua deploy writes the version it made live.
• Every push except lua push agent ends with a source backup and updates backup.

​

Hand edits

• Changing version: overwritten by the server’s active version the next time the CLI reconciles. To push a specific version use lua push <type> --set-version <ver>; to bump automatically use --force.
• Deleting an id line: the next lua push or lua sync links the row to the server entity with the same name, or registers a new one when none exists, and writes the id. This is the fix when the server entity was deleted and a push fails with no longer exists on the server (exit 3); for workflows the CLI clears a stale id itself.
• Deleting a row: lua compile recreates it while the primitive is still in the code.
• Removing a primitive from the code: its row disappears on compile, but the server copy stays and returns as a server-only row on the next push or sync until you delete it with that primitive’s delete action, for example lua webhooks delete.
• Changing agentId or orgId: use lua init --agent-id <id> --force instead; it also updates the LuaAgent name and persona in src/index.ts.
• Editing backup or git: the next push or lua git connect overwrites them.
• Editing template: intended. Every section is sent on lua marketplace template publish; an absent section clears that part of the template rather than keeping the previous value.

​

See also

• lua compile and lua push
• lua sync — resolve drift between this file, your code, and the server
• Project structure
• Agent templates — the template: section