Skills

Skills

Step-by-step notes for one kind of task. The agent reads a skill when a request matches.

Coming soon
AI agents are not available on StackBlaze yet. This page describes how they work so you can plan for them; names, limits and details can change before they are released.

A skill is a short set of steps for one kind of task, like handling a refund. The agent sees each skill's name and description. When a request matches, it reads the steps.

Open the agent, go to Agent → Skills, and click New skill.

FieldWhat to enter
NameLowercase letters, digits and dashes, up to 40. For example refund-policy. It cannot change later.
When to use itOne line, up to 300 characters. For example "A customer asks for a refund or wants to return an order".
StepsThe instructions, in Markdown, up to 40,000 characters.
Steps
1. Ask for the order number.
2. Refunds are allowed within 30 days of delivery.
3. If it is later than that, offer store credit and hand over to a person.

Click Save skill. An agent can have up to 50 skills. Skills save at once. New chats use them. Open chats keep what they had.

Skills need read

The agent reads a skill's steps with its read tool. If read is off, the Skills tab says so. Turn it on in General → Tools. The agent can read its skills but never change them.

Skills or instructions

Put what applies to every chat in the instructions. Put steps for one kind of request in a skill. The agent only loads a skill's steps when it needs them.

API

GET /api/ai-agents/{pipeline}/{phase}/{name}/skills lists them. PUT …/skills/{skill} with { "description", "body" } creates or replaces one. GET and DELETE on …/skills/{skill} read and remove one. See API.