Skill System

---
name: skill-name
description: Brief description for agent selection
mcpServers:
  server-name:
    command: npx
    args: ["@package/name@latest"]
allowedTools:
  - "Bash(pattern:*)"
  - "Read"
providersGating:
  - anthropic
---

# Skill Content

Markdown content injected into agent context when skill is loaded.

// Config location: src/features/builtin-skills/skills/git-master.ts:8
export const gitMasterSkill: BuiltinSkill = {
  name: "git-master",
  description: "Git operations: commits, rebase, history search",
  template: `...1111 lines of Git expertise...`,
}

export const playwrightSkill: BuiltinSkill = {
  name: "playwright",
  description: "MUST USE for browser tasks via Playwright MCP",
  template: `# Playwright Browser Automation...`,
  mcpConfig: {
    playwright: {
      command: "npx",
      args: ["@playwright/mcp@latest"],
    },
  },
}

export const agentBrowserSkill: BuiltinSkill = {
  name: "agent-browser",
  description: "MUST USE for browser tasks via agent-browser CLI",
  template: `...296 lines of CLI reference...`,
  allowedTools: ["Bash(agent-browser:*)"],
}

export const frontendUiUxSkill: BuiltinSkill = {
  name: "frontend-ui-ux",
  description: "Designer-turned-developer for stunning UI/UX",
  template: `# Role: Designer-Turned-Developer...`,
}

{
  "browser_automation_engine": "agent-browser"  // or "playwright" or "playwright-cli"
}

// src/features/opencode-skill-loader/skill-discovery.ts
1. Scan 4 scopes for SKILL.md files
2. Parse YAML frontmatter
3. Deduplicate by name (project > opencode > user > global)
4. Resolve template variables
5. Merge skill definitions

// src/features/skill-mcp-manager/manager.ts:9
export class SkillMcpManager {
  async getOrCreateClient(
    info: SkillMcpClientInfo,
    config: ClaudeCodeMcpServer
  ): Promise<Client>

  async listTools(info, context): Promise<Tool[]>
  async callTool(info, context, name, args): Promise<unknown>
  async disconnectSession(sessionID: string): Promise<void>
}

{
  "disabled_skills": [
    "playwright",
    "git-master"
  ]
}

{
  "skills": {
    "sources": [
      ".opencode/skills",
      "~/my-skills"
    ],
    "recursive": true
  }
}

{
  "agents": {
    "sisyphus": {
      "skills": ["git-master", "frontend-ui-ux"]
    },
    "hephaestus": {
      "skills": ["playwright"]
    }
  }
}

---
name: my-skill
description: My custom skill
mcpServers:
  my-server:
    command: node
    args: ["./server.js"]
allowedTools:
  - "Bash(*)"
---

# My Skill

Custom instructions injected into agent context.