Skill

A Skill is a behavior package the agent activates only when the user’s request is relevant to its description. It’s the Claude “skills” model: instead of putting everything in the base prompt, you encapsulate specific capabilities that turn on when needed.

It connects to the skills port of an AI Agent and you can connect several. When a skill activates, it does two things: injects its instructions into the prompt and enables its tools.

Configuration

Field	Type	Required	Description
skill_name	text	Yes	Skill name (e.g. billing).
description	textarea	Yes	When to use it. Compared against the request to decide whether to activate.
keywords	text	No	Keywords (CSV) that trigger it (e.g. invoice, receipt, vat).
prompt_fragment	textarea	No	Instructions it injects when activated.
enables_tools	text	No	Tools (CSV of names) this skill enables.
attach_to	text	Yes*	Agent alias.

How it activates

The agent activates the skill if the user’s request matches any of its keywords or words in its description. On activation:

1. It adds the prompt_fragment to the system prompt.
2. It enables the tools in its enables_tools.

Tool gating

If a tool appears in some skill’s enables_tools, that tool stays hidden until the skill activates. Tools not in any skill are always available. This way the LLM doesn’t see tools out of context.

Example — Billing skill

A support agent with a skill that only applies to tax topics and enables the invoice-issuing tool.

1. Have a Tool issue_invoice connected to the tools port.
2. Skill:
   • skill_name: billing
   • description: “Issuing invoices and receipts, VAT queries and tax data.”
   • keywords: invoice, receipt, vat, tax
   • prompt_fragment: “When issuing an invoice, first confirm the customer’s tax details.”
   • enables_tools: issue_invoice
3. Connect it to the skills port (pink).

Result:

• General question → the skill does not activate and issue_invoice is not offered to the LLM.
• The user mentions “invoice” or “VAT” → the skill activates: it injects its instruction and enables issue_invoice.

Caution

If the skill does not activate when it should, add keywords closer to the user’s real vocabulary. If it activates too much, narrow the keywords and make the description more specific. And remember: a tool in enables_tools doesn’t appear until its skill activates — if it must always be available, don’t put it in a skill.

See also

• AI Agent (orchestrator) · Tool
• Examples and recipes · Common problems
• Agent library — ready-made skills, tools, prompts and kits to insert into your agent.