Skip to main content
A skill is a folder of instructions mounted into the agent’s run. Give a job one or more with --skills; every arm gets them.
--skills (also spelled --skill) repeats, and accepts:
  • skills.sh/<owner>/<repo>[/<skill>]
  • org/repo[@ref]
  • an https git URL
  • upload:<id>, a skill you uploaded
  • name:<skill-name>, your moving name pointer, resolved on the server to its current upload
  • a local folder, which is uploaded first and then referenced

​
Upload a skill

The folder’s name becomes your moving name pointer: name:my-skill resolves to the latest upload with that name, and an unknown name is refused with skill_name_not_found. skill show prints the metadata and the SKILL.md. A skill that a running job references cannot be deleted, and past jobs keep the version they ran with. The job’s arm records what mounted under skill_locks: name, pinned source, digest and, for a git skill, the repository and commit. A skill that cannot be fetched fails the trial as an infrastructure error, never as a score.

skill reference

Every flag of evolve skill.