Skip to main content
A task can include skills in its environment so every agent running the task receives the same instructions and reference files. Each skill is a directory containing a SKILL.md file.

​
Add skills to a task

Place the skills in the environment build context:
Copy them into the image:
environment/Dockerfile
Then point environment.skills_dir to that sandbox directory:
task.toml
Use an absolute sandbox path. This is required when task skills are combined with skills supplied at job runtime.

​
How Harbor passes task skills

Harbor does not upload the task’s skill files separately: they already exist in the built or prebuilt environment at environment.skills_dir. Before creating the agent, Harbor passes that path to the agent integration as skills_dir. Compatible pre-integrated agents then copy or register the skills in their native configuration directory. A custom agent receives skills_dir in its constructor and should use it during setup() or run(). The path remains available in the sandbox as well.
Setting environment.skills_dir does not copy files into the environment. Ensure the directory exists in the built or prebuilt image.

​
Combine task and job skills

Job-provided skills are uploaded into the task’s environment.skills_dir, so the agent receives both sources through one directory. A job-provided skill replaces a bundled skill with the same directory name for that trial. If the task does not declare environment.skills_dir, job-provided skills use /harbor/skills.