Skip to content

Reference & Data Model

Agent skill (agent_skill)

An agent skill is a named set of instructions that Polaris and agents load on demand.

An agent skill stores a procedure as a prompt. Agents receive it via assignment, Polaris via the flag „Use in Polaris“. In Polaris, / in the input field brings up the released skills. (Data type: configuration)

Aligia AI › Agenten › Agenten-Skills (page title „Skill-Bibliothek“ – Skill library). The list shows status, trigger, run mode, visibility and agents. The detail page has name, description, instructions, the toggles „Status“ and „Use in Polaris“ as well as „Von Agenten benutzt“ (Used by agents). See Guides › Agent skills.

Field Technical Type Required Meaning Notes
Name name Text yes display name –
Description description Text yes when the skill applies; basis for selection by agents Markdown
Instructions instructions Text no the actual prompt Markdown; placeholders {{variable}} possible
Status status Selection yes „Aktiv“ (Active, active) / „Entwurf“ (Draft, draft) toggle on the detail page; default „Entwurf“
Use in Polaris polaris Yes/No yes Polaris loads the skill default no
Trigger trigger Selection yes „Automatisch“ (Automatic, auto), „Slash-Befehl“ (Slash command, command), „Nur Erwähnung“ (Mention only, mention) display and creation dialog only; no effect at runtime
Run mode run_mode Selection yes „Antwort“ (Reply, reply), „Automatisch ausführen“ (Auto-run, autorun), approval display and creation dialog only; no effect at runtime
Visibility visibility Selection yes private, team, „Organisation“ (org) display and creation dialog only; no effect at runtime
Archived archived_at Date no via context menu „Archivieren“ (Archive) archived skills stay assigned to agents
Related to Kind Required On archive On delete
Agent (agent_skill_map) n:m no kept mapping deleted along
Value Label Meaning
draft Entwurf (Draft) not loaded into runs. Default.
active Aktiv (Active) loaded if assigned or released for Polaris.

The toggle on the detail page switches between exactly these two values.

  • Only skills with status „Aktiv“ and without a deletion mark are loaded into a run. For Polaris, „Use in Polaris“ applies additionally.
  • Trigger, run mode and visibility are stored and shown in the list and the creation dialog, but no runtime path reads them.
  • Context menu: status, archive, duplicate, delete.

Agent · Conversation