Skip to main content
A skill is a reusable instruction bundle that teaches an agent how to perform a task. A tool executes code; a skill provides a procedure, checklist, or domain playbook the agent can load when relevant.

Create a skill

Add a directory containing SKILL.md under the agent:
Write a clear name and routing description in the frontmatter, then put the full procedure in the body:
The description should say both what the skill does and when it applies. The agent uses it to decide whether to load the instructions.

Use the skill

Skills do not need a hook. OpenComputer packages the entire skills/ directory with that agent, which can load a matching skill during the session. Tell the agent when the skill should guide its work:

Add supporting files

Keep the core procedure in SKILL.md. Put longer material beside it:
Reference those files from SKILL.md so the agent knows when to read them. Supporting files are deployed with the skill and need no imports from agent.ts.

Scope skills to an agent

Skills live under opencomputer/agents/<agent-id>/skills/, so each deployment receives only its own skill set. To reuse a skill, copy or generate the skill directory into each agent that needs it.

Skills versus tools

Many useful workflows combine both: a research skill explains the process while the GTM engineer example uses an Exa search tool to retrieve current sources.