Skip to main content
For the complete documentation index for agents and LLMs, see llms.txt.

Add Skills to an Agent

Attach skills to an Agent so it can read their instructions and reference material while it runs.


Add a Skill​

You can attach skills to the Agent. Skills are versioned folders of files, such as instructions and reference material, that the Agent reads while it runs. For an explanation of skills, see Agent Skills.

Haystack Version for Skills

To add skills to the Agent in your pipeline, the pipeline must use Haystack version 3.2.0 or higher. To change the Haystack version a pipeline is using, open the pipeline and go to its settings. For details, see Pin the Haystack Version.

  1. Click the Agent to open its configuration and in the Skills section, click Add Skill.
  2. Browse or filter the skills, then click the skill you want to use.
  3. Choose the version you want the Agent to use and click Add.

The skill appears in the Agent's Skills section. When the Agent runs, it can read the files in that skill at the version you chose. For instructions on how to create skills and connect a GitHub repository with skills, see Manage Agent Skills.

Add Skills to an Agent in a Pipeline Tool​

If a pipeline tool contains an Agent, you can give that Agent its own skills, for example to give a specialized sub-agent its own instructions and reference material.

  1. In the Tools section of the parent Agent, click the pipeline tool to open the tool editor.
  2. Select the Agent inside the pipeline tool.
  3. In its Skills section, add skills as described in Add a Skill.

The skill appears in the nested Agent's Skills section. The skills work when you run or deploy the parent pipeline, the same way as skills on the parent Agent. Pipelines with skills on a nested Agent run on a Haystack version that supports skills. If the deployment fails because a DEEPSET_SKILLS_DIR_ environment variable isn't set, see Skills Environment Variable Not Set on a Nested Agent.