Skills
2 min read
A skill defines how an agent should carry out a specific procedure. It turns a repeatable process—such as reviewing a document, preparing a report, or classifying a request—into a guide that can be reused across agents.
What a skill includes
| Element | Purpose |
|---|---|
| Name | Identifies the procedure for the team. |
| Description | Helps the agent recognize when it should use it. |
| Instructions | Describes steps, criteria, exceptions, and examples in Markdown. |
| Optional model and effort | Temporarily override the agent's configuration for that task. |
A skill can be assigned to several agents. Adding or removing it does not require a restart: the change is available when the agent finishes its current work.
Write a useful skill
Define the outcome
Explain what the agent must deliver and what conditions it must meet before considering the task complete.
Describe the procedure
Order the steps, state what information it should consult, and define cases that need an exception or approval.
Add examples when they prevent ambiguity
Include short examples of a valid answer, an expected format, or a situation it must reject.
Write the description for the agent
Use a sentence that describes the situation in which to use it: “Review text to find mistakes and adjust the tone” is more useful than “Review v2”.
Model and effort per task
A skill can request a model or effort level different from the usual one. Use this to reserve the most capable models for tasks that genuinely need them, without changing the agent's base configuration.
If you leave these fields empty, the skill inherits the agent's model and effort.
Versions and permissions
Archived skills can be recovered. Edits retain versions according to the organization policy, which you can review in Organization.
Agents can manage their own skills only when they have that capability enabled. Review it in Behaviour and limits.
Skill marketplace Planned
We are preparing a marketplace to discover and apply skills created by Kujira and the community. It will let you incorporate solved procedures without writing them from scratch, then adapt them to each organization's rules.
In preparation
The marketplace is not available yet. In the meantime, you can create your own skills and reuse them across the agents in your organization.
See Memories to store stable context instead of procedures.