Summary

Add support for self-hosted workers to discover and report locally available skills to the server via a new worker_skills WebSocket message, so they appear in the Oz webapp's agent selector dropdown for users with access to the worker.

Problem

Self-hosted workers don't use Warp environments, so the webapp can't auto-populate the skills dropdown. The only workaround was pasting skill paths into the prompt, which is unsustainable for enterprises.

Solution

Config

Add a top-level skills_dirs field to the worker YAML config — a list of filesystem directories containing skill folders:

worker_id: "my-worker"
skills_dirs:
  - /opt/skills
  - /home/user/my-skills

Each directory should contain subdirectories with a SKILL.md file following the standard skill folder convention (<dir>/skill-name/SKILL.md).

Protocol

On each WebSocket connect, the worker:

1. Scans configured directories for SKILL.md files
2. Parses YAML frontmatter (name, description) and body content (base prompt)
3. Sends a worker_skills message to the server with the full skill metadata

{
  "type": "worker_skills",
  "data": {
    "skills": [
      {
        "name": "code-review",
        "description": "Review code changes for bugs and style issues",
        "path": "/opt/skills/code-review/SKILL.md",
        "base_prompt": "You are a code reviewer. Review the diff for..."
      }
    ]
  }
}

Helm Chart

worker.skillsDirs added to values.yaml and rendered in the ConfigMap template.

Files Changed

• internal/config/config.go — Add SkillsDirs to FileConfig
• internal/types/messages.go — Add WorkerSkill, WorkerSkillsMessage, MessageTypeWorkerSkills
• internal/worker/skills.go (new) — Directory scanning and SKILL.md parsing
• internal/worker/worker.go — Send worker_skills on connect
• main.go — Wire skills_dirs through mergeConfig
• charts/oz-agent-worker/ — Helm chart support

Testing

• Unit tests for SKILL.md parsing (frontmatter extraction, base prompt, error cases)
• Unit tests for directory scanning (valid skills, invalid/missing/dedup, nonexistent dirs)
• Config loading tests for skills_dirs

Companion PR

Server-side changes: warpdotdev/warp-server#10385

Oz conversation | Plan

Co-Authored-By: Oz oz-agent@warp.dev