AGENTS.md

1# src/features/builtin-skills/ — 12 Built-in Skill Files
2 
3**Generated:** 2026-07-17 (7d664b96b)
4 
5## OVERVIEW
6 
7Skills shipped inside the plugin (always available, no install). Registered via `createBuiltinSkills()`. Each skill implements the `BuiltinSkill` interface with name, description, content, and optional MCP config. Loaded by `opencode-skill-loader` with priority: project > opencode > user > **builtin**. User-installed skills with the same name override built-ins.
8 
9## STRUCTURE
10 
11```
12builtin-skills/
13├── index.ts              # Barrel exports
14├── skills.ts             # createBuiltinSkills() factory — registers all 12 below
15├── types.ts              # BuiltinSkill interface
16├── skills/
17│   ├── git-master.ts                  # 1111 LOC
18│   ├── git-master-skill-metadata.ts   # Companion to git-master
19│   ├── playwright.ts                  # MCP variant + agent-browser
20│   ├── playwright-cli.ts              # CLI variant
21│   ├── dev-browser.ts                 # Persistent page state
22│   ├── frontend.ts              # Design-first UI guidance
23│   ├── review-work.ts                 # 5-agent post-implementation review
24│   ├── remove-ai-slops.ts             # Shared skill loader for remove-ai-slops
25│   ├── init-deep.ts                   # Shared skill loader for init-deep
26│   ├── team-mode.ts                   # 12 team_* tool documentation (gated)
27│   ├── security-research.ts           # Team Mode exploitability-driven security research
28│   ├── security-review.ts             # Alias for security-research
29│   ├── git-master-sections/           # Git-master prompt sub-sections
30│   └── index.ts                       # skill barrel
31├── git-master/                        # Resources for git-master skill
32├── frontend/                    # Resources for frontend skill
33├── agent-browser/                     # Resources for agent-browser variant
34├── dev-browser/                       # Resources for dev-browser
35└── security-research/                 # Resources for security-research
36```
37 
38## SKILL CATALOG
39 
40| Skill | Approx LOC | MCP | Notes |
41|-------|------------|-----|-------|
42| `git-master` | 1111 | — | Atomic commits, rebase, history search; included by default for delegate-task `git` category |
43| `playwright` | 312 | `@playwright/mcp` | Browser automation via MCP |
44| `playwright-cli` | 268 | — | Browser automation via shell CLI (no MCP) |
45| `agent-browser` | (in playwright.ts) | — | Browser via `agent-browser:*` Bash commands |
46| `dev-browser` | 221 | — | Persistent page state browser for dev work |
47| `frontend` | 79 | — | Design-first UI development guidance |
48| `review-work` | ~500 | — | Post-implementation review orchestrator (5 parallel agents) |
49| `$omo:remove-ai-slops` | — | — | Remove AI-generated code smells |
50| `init-deep` | — | — | Hierarchical AGENTS.md generation |
51| `security-research` | SKILL.md | — | Team Mode exploitability-driven security research |
52| `security-review` | wrapper | — | Alias for `security-research` |
53| `team-mode` | — | — | **Conditional** — only loaded when `team_mode.enabled`; documents the 12 `team_*` tools and lifecycle |
54 
55## BROWSER VARIANT SELECTION
56 
57Config `browser_automation_engine` selects which browser skill loads:
58 
59| Value | Skill Loaded |
60|-------|-------------|
61| `"playwright"` (default) | playwright (MCP-backed) |
62| `"playwright-cli"` | playwright-cli (CLI-backed) |
63| `"agent-browser"` | agent-browser (in playwright.ts) |
64 
65Only one browser skill is active per session; non-selected variants are skipped.
66 
67For the `playwright` (MCP) variant, `browser_automation_engine.playwright_mcp_args` (string array) appends extra CLI flags after the default `npx @playwright/mcp@latest` invocation, e.g. `--executable-path` or `--no-sandbox` for sandboxed envs lacking a system Chrome. Threaded via `createBuiltinSkills({ playwrightMcpArgs })` into `createPlaywrightSkill({ mcp_args })` (`skills/playwright-mcp-skill.ts`); absent or empty leaves the default singleton byte-identical.
68 
69## TEAM-MODE SKILL GATING
70 
71The `team-mode` skill is registered unconditionally but only **rendered** when `team_mode.enabled: true`:
72 
73```typescript
74// skills/team-mode.ts (paraphrase)
75const teamModeSkill: BuiltinSkill = {
76  name: "team-mode",
77  shouldLoad: (config) => config.team_mode?.enabled === true,
78  // ...
79}
80```
81 
82When disabled, the skill is filtered out before agent prompt assembly so agents do not see `team_*` tool docs they cannot use.
83 
84## ADDING A NEW BUILT-IN SKILL
85 
861. Create `skills/{name}.ts` exporting a `BuiltinSkill` object
872. Register in `skills.ts` `createBuiltinSkills()` factory
883. Add resources (if any) under a sibling directory: `{name}/SKILL.md`, prompt sections, etc.
894. If the skill is conditional, set `shouldLoad: (config) => …`
905. Optionally declare an MCP server in the skill (loaded by `skill-mcp-manager` per session)
91