Appearance

ts ai skill ​

Enable or disable a stored skill definition. ts ai skills lists the skill definitions stored in this server's database.

Usage ​

text
ts ai skills [--csv] [--no-trunc]
ts ai skill set <id> enabled true|false

Description ​

ts ai skills lists stored skill definitions only — rows in this server's configuration, typically seeded or synced from an upstream source. Skills compiled into the server and skills supplied by application manifests have no stored row, so they are absent from this listing. A short list is not evidence of a short catalog. When nothing is stored the command says so in words rather than printing an empty table.

The merged view — compiled, manifest, and stored definitions combined into the skills that can actually run — is the effective catalog at /api/agent-catalog. ts does not expose it, and the endpoint requires a service scope rather than an administrator login, so the Administration site under Intelligence → Skills is where you look at the real catalog.

Rows are ordered by definition id. ID is that definition id, a stable string name rather than a GUID, and it is what other configuration references. VERSION tells you whether a synced skill is current. ORIGIN is local for a definition authored here, or the federation sync state — Synced, Conflicted, Unsupported — for one that came from upstream. Conflicted means the stored row and the upstream definition disagree and someone needs to resolve it. Add --format=json for the row GUID, published flag, and last-updated timestamp.

Enablement Is The Whole Surface ​

ts ai skill set <id> enabled true|false is the only write, and it is the only write anywhere. Skill definition JSON cannot be authored from ts, and the Administration site cannot author one either — a definition arrives by federation or by seeding. There is no create, no edit, and no delete to look for; toggling a stored row on or off is the entire administrative surface for a skill.

The <id> is the definition id, the ID column of ts ai skills — not a GUID, and not a display name. There is no name resolution here and no print form: ts ai skill <id> on its own is a usage error, because set is the only action.

Because only stored rows can be toggled, an id that exists solely in the effective catalog — compiled into the server, or supplied by a manifest — has nothing to write to and the command reports that it has no stored definition row. That is the same distinction the listing draws, seen from the write side.

Changes are recorded in the audit log as FederatedContentEnablementChanged, with ai/skill as the content kind.

Options ​

FlagDescriptionDefault/ValuesNotes
--csvTab-separated output, nothing truncated.ts ai skills only.
--no-truncDo not truncate columns.ts ai skills only.

Examples ​

bash
# Which skills have a stored definition here?
ts ai skills

# Full ids, nothing clipped
ts ai skills --no-trunc

# With row ids and timestamps
ts ai skills --format=json

# Turn a stored skill off
ts ai skill set summarize-logs enabled false

# And back on
ts ai skill set summarize-logs enabled true

# Snapshot for comparison against another server
ts ai skills --csv > skills.tsv
bash
# Nothing listed does not mean no skills are available — compiled and
# manifest skills are invisible here, and cannot be toggled here either.
# Check Intelligence → Skills in the Administration site.
ts ai skills

Output ​

text
ID                VERSION  ENABLED  ORIGIN
summarize-logs    2        yes      Synced
triage-crash      1        yes      local

Exit Codes ​

0 on success, including when no stored definitions exist. -1 when the property is not enabled, or when the value is not true or false. -2 when the command is not a well-formed set <id> enabled <value> — including ts ai skill <id> with no action. -3 when the server cannot be reached. -4 when no account is signed in or the ticket has expired. -5 when the account is not a Server Administrator. -6 when the id has no stored definition row.

Turbo.net © 2025