---
title: "Teach an agent a job with a skill"
description: "Define when a skill runs, its goal, steps, tools and handover rules, then test and publish it."
url: https://help.gleap.ai/pt/articles/16752001-teach-an-agent-a-job-with-a-skill
collection: "Custom AI agents and skills"
updated: 2026-11-01
language: pt
alternates: [en]
---

# Teach an agent a job with a skill

Define when a skill runs, its goal, steps, tools and handover rules, then test and publish it.

A skill is a repeatable job an agent can carry through from start to finish. Examples include resending an invoice, collecting the details of a bug or preparing a weekly summary.

Open **AI agents**, choose Kai Support or your custom agent, then open **Skills**.

### Create a skill

1.  Choose the option to add a skill and describe the job, or use **Write a skill yourself** where available.
    
2.  Give it a clear name.
    
3.  Under **When to use it**, describe the request or event that should start it. Add **Use when** and **Don’t use when** guidance where shown.
    
4.  Write the goal and steps.
    
5.  Choose the tools, knowledge, fields and handovers it needs.
    
6.  Define **Hand off when** and **When it’s done**.
    

![Kai support skills screen in the Pied Piper demo project.](https://staticfiles.gleap.io/p613b5dd730aed737108f87ab/MRVM48ZRaiPVUO2b7PTiMPvdh5LeppIl9mINPkqGpNgB0gDqQZFUCyox7ysI8YFEIA2P9VfSqSK.png)

![Copilot skills screen in the Pied Piper demo project.](https://staticfiles.gleap.io/p613b5dd730aed737108f87ab/oojhxynM079JiWTpVssG4DybUoVy0pwX3uFw3Kz1c3ufXCm7S2fNzk0y3FesCMNRIJAHiNuEsfL.png)

Start with one job. “Handle billing” is too broad; “Resend an existing invoice to the email on file” gives you a result you can test.

### Review tool permissions

A skill can only use tools available to its agent and actions allowed by those tools. Review the connected app before giving a skill a process that changes customer data.

A skill’s instructions explain the process; tool permissions still apply.

### Test before publishing

Use the **Test** pane to try the draft and, when available, replay it on past conversations. Check a normal case, missing information and a case that should hand over.

Test results show which version was tested. Editing the draft afterwards can make a previous result stale.

### Publish and maintain

Choose **Publish** when the draft is ready. Publishing makes it live for the intended audience; testing does not publish it. The stage and status controls show whether it is draft, live or paused.

Keep watching real outcomes. Pause a skill that is behaving incorrectly, fix the draft and test again. Use its history to understand what changed.

### Related

-   [What a custom agent is made of](https://help.gleap.ai/en/articles/246-what-a-custom-agent-is-made-of.md)
    
-   [Connect a tool to an agent](https://help.gleap.ai/en/articles/248-connect-a-tool-to-an-agent.md)
    
-   [Fix a wrong answer](https://help.gleap.ai/en/articles/245-fix-a-wrong-answer.md)