Skills
Discover, create, and use reusable agent instructions across Worktree and individual Workspaces.
Skills are reusable instructions exposed to the agent and as slash commands. Open Settings → Skills to search, inspect, upload, or create them.
Global skills
Global skills are available across Worktree. Skills created in Worktree are stored under ~/.worktree/skills. Worktree also discovers compatible skills from the global Claude, Codex, OpenCode, and Agents directories and labels their source in the list.
Workspace skills
Choose a Workspace from the scope menu to see the skills available in that repository. Skills created or uploaded for a Workspace are stored under .agents/skills, so they can travel with the repository and work across compatible agents.
Repository skills are discovered while the Local host or Cloud sandbox is connected. Worktree keeps the last successful list available while a Workspace is offline and refreshes it when the runtime reconnects.
Skill format
Each skill lives in its own directory with a SKILL.md file. The file needs name and description frontmatter followed by the instructions the agent should follow. Worktree validates uploaded and newly created skills before saving them.
