opencodekit 0.18.1 → 0.18.2

package/dist/index.js

@@ -18,7 +18,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 //#endregion
 //#region package.json
-var version = "0.18.1";
+var version = "0.18.2";
 
 //#endregion
 //#region src/utils/errors.ts

package/dist/template/.opencode/skill/accessibility-audit/SKILL.md

@@ -1,12 +1,13 @@
 ---
 name: accessibility-audit
 description: Use when auditing UI components or pages for accessibility compliance, checking WCAG conformance, identifying keyboard navigation issues, color contrast problems, and pre-launch accessibility verification
+version: 1.0.0
+tags: [ui, code-quality]
+dependencies: []
 ---
 
 # Accessibility Audit Skill
 
-Audit UI accessibility against WCAG 2.1/2.2 guidelines.
-
 ## When to Use
 
 - Reviewing UI components for accessibility compliance
@@ -15,6 +16,11 @@ Audit UI accessibility against WCAG 2.1/2.2 guidelines.
 - Checking color contrast
 - Pre-launch accessibility verification
 
+## When NOT to Use
+
+- Non-UI work where accessibility isn't applicable.
+
+
 ## Core Workflow
 
 ### Phase 1: Visual Accessibility Analysis
@@ -179,7 +185,7 @@ Save audit reports to `.opencode/memory/design/accessibility/`
 
 ## Related Skills
 
-| Need           | Skill                 |
-| -------------- | --------------------- |
+| Need           | Skill             |
+| -------------- | ----------------- |
 | Design quality | `frontend-design` |
-| UI research    | `ui-ux-research`      |
+| UI research    | `ui-ux-research`  |

package/dist/template/.opencode/skill/agent-browser/SKILL.md

@@ -1,12 +1,21 @@
 ---
 name: agent-browser
 description: Browser automation CLI for AI agents using Playwright
-version: 1
+version: 1.0.0
+tags: [automation, mcp]
+dependencies: []
 ---
 
 # agent-browser
 
-Browser automation CLI for AI agents. Use when tasks require web browsing, scraping, form filling, or web interaction. Built on Playwright with Rust CLI + Node.js daemon architecture.
+## When to Use
+
+- When you need Playwright-based browser automation via the agent-browser CLI.
+
+## When NOT to Use
+
+- When MCP-based browser control is required instead of a CLI workflow.
+
 
 ## Installation
 
@@ -50,28 +59,33 @@ agent-browser get text @e1        # Get heading text
 Ref syntax: `@e1`, `e1`, or `ref=e1` all work.
 
 **Why refs?**
+
 - Deterministic: points to exact element from snapshot
 - Fast: no DOM re-query, uses cached role/name locator
 - AI-friendly: snapshot + ref workflow optimal for LLMs
 
 ### Interactive Roles (get refs automatically)
+
 `button`, `link`, `textbox`, `checkbox`, `radio`, `combobox`, `listbox`, `menuitem`, `option`, `searchbox`, `slider`, `spinbutton`, `switch`, `tab`, `treeitem`
 
 ### Content Roles (get refs when named)
+
 `heading`, `cell`, `gridcell`, `columnheader`, `rowheader`, `listitem`, `article`, `region`, `main`, `navigation`
 
 ## Commands
 
 ### Navigation
+
 ```bash
 agent-browser open <url>          # Auto-prepends https:// if needed
 agent-browser back
-agent-browser forward  
+agent-browser forward
 agent-browser reload
 agent-browser close               # Closes browser + daemon
 ```
 
 ### Interaction
+
 ```bash
 agent-browser click <sel>         # Left click
 agent-browser dblclick <sel>      # Double click
@@ -92,6 +106,7 @@ agent-browser upload <sel> <file1> [file2...]
 ```
 
 ### Get Info
+
 ```bash
 agent-browser get text <sel>      # textContent
 agent-browser get html <sel>      # innerHTML
@@ -104,6 +119,7 @@ agent-browser get box <sel>       # Bounding box {x,y,width,height}
 ```
 
 ### Check State
+
 ```bash
 agent-browser is visible <sel>
 agent-browser is enabled <sel>
@@ -111,6 +127,7 @@ agent-browser is checked <sel>
 ```
 
 ### Snapshot Options
+
 ```bash
 agent-browser snapshot            # Full accessibility tree
 agent-browser snapshot -i         # Interactive elements only (buttons, inputs, links)
@@ -121,6 +138,7 @@ agent-browser snapshot -i -c -d 5 # Combine options
 ```
 
 ### Screenshots & PDF
+
 ```bash
 agent-browser screenshot [path]   # PNG to stdout (base64) or file
 agent-browser screenshot --full   # Full page screenshot
@@ -129,6 +147,7 @@ agent-browser pdf <path>          # Save as PDF (format: Letter, A4, etc)
 ```
 
 ### Wait
+
 ```bash
 agent-browser wait <selector>     # Wait for element visible
 agent-browser wait <ms>           # Wait for time (numeric = milliseconds)
@@ -139,6 +158,7 @@ agent-browser wait --fn "window.ready === true"  # Wait for JS condition
 ```
 
 ### Find (Semantic Locators)
+
 ```bash
 agent-browser find role button click --name "Submit"
 agent-browser find text "Sign In" click
@@ -155,6 +175,7 @@ agent-browser find nth 2 "a" text          # Nth match (0-indexed)
 Actions: `click`, `fill`, `check`, `hover`, `text`
 
 ### Sessions (Isolated Browser Instances)
+
 ```bash
 agent-browser --session agent1 open site-a.com
 agent-browser --session agent2 open site-b.com
@@ -167,6 +188,7 @@ agent-browser session             # Show current session
 Each session has: own browser, cookies/storage, navigation history, auth state.
 
 ### Storage & Cookies
+
 ```bash
 agent-browser cookies             # Get all cookies
 agent-browser cookies set <name> <val>
@@ -180,6 +202,7 @@ agent-browser storage session     # Same for sessionStorage
 ```
 
 ### Tabs & Windows
+
 ```bash
 agent-browser tab                 # List tabs
 agent-browser tab new [url]       # New tab
@@ -189,18 +212,21 @@ agent-browser window new          # New window (new context)
 ```
 
 ### Frames
+
 ```bash
 agent-browser frame <sel>         # Switch to iframe by selector
 agent-browser frame main          # Back to main frame
 ```
 
 ### Dialogs (alert/confirm/prompt)
+
 ```bash
 agent-browser dialog accept [text]  # Accept (with optional prompt text)
 agent-browser dialog dismiss        # Dismiss
 ```
 
 ### Network Interception
+
 ```bash
 agent-browser network route <url>              # Intercept requests
 agent-browser network route <url> --abort      # Block requests
@@ -211,6 +237,7 @@ agent-browser network requests --filter api    # Filter by URL pattern
 ```
 
 ### Browser Settings
+
 ```bash
 agent-browser set viewport <w> <h>
 agent-browser set device "iPhone 14"   # Emulate device
@@ -222,6 +249,7 @@ agent-browser set headers '{"X-Custom":"value"}'
 ```
 
 ### Debug & Tracing
+
 ```bash
 agent-browser --headed open <url>   # Show browser window (not headless)
 agent-browser console               # View console messages
@@ -235,12 +263,14 @@ agent-browser trace stop [path]     # Stop and save trace
 ```
 
 ### Auth State Persistence
+
 ```bash
 agent-browser state save auth.json  # Save cookies, localStorage, sessionStorage
 agent-browser state load auth.json  # Load at next launch (must be at browser start)
 ```
 
 ### Mouse Control
+
 ```bash
 agent-browser mouse move <x> <y>    # Move to coordinates
 agent-browser mouse down [button]   # left|right|middle
@@ -250,15 +280,15 @@ agent-browser mouse wheel <dy> [dx] # Scroll wheel
 
 ## Options
 
-| Option | Description |
-|--------|-------------|
+| Option             | Description                                       |
+| ------------------ | ------------------------------------------------- |
 | `--session <name>` | Isolated session (or `AGENT_BROWSER_SESSION` env) |
-| `--json` | JSON output (for parsing) |
-| `--full, -f` | Full page screenshot |
-| `--headed` | Show browser window |
-| `--name, -n` | Locator name filter |
-| `--exact` | Exact text match |
-| `--debug` | Debug output |
+| `--json`           | JSON output (for parsing)                         |
+| `--full, -f`       | Full page screenshot                              |
+| `--headed`         | Show browser window                               |
+| `--name, -n`       | Locator name filter                               |
+| `--exact`          | Exact text match                                  |
+| `--debug`          | Debug output                                      |
 
 ## Selector Types
 
@@ -283,6 +313,7 @@ agent-browser is visible @e2 --json
 ## Patterns
 
 ### Login Flow
+
 ```bash
 agent-browser open https://example.com/login
 agent-browser snapshot -i
@@ -295,6 +326,7 @@ agent-browser state save auth.json  # Persist auth for later
 ```
 
 ### Form Submission
+
 ```bash
 agent-browser open https://example.com/form
 agent-browser snapshot -i --json
@@ -308,6 +340,7 @@ agent-browser wait --text "Success"
 ```
 
 ### Scraping Data
+
 ```bash
 agent-browser open https://example.com/data
 agent-browser snapshot
@@ -318,6 +351,7 @@ agent-browser eval "JSON.stringify([...document.querySelectorAll('.price')].map(
 ```
 
 ### Multi-page Navigation
+
 ```bash
 agent-browser open https://example.com
 agent-browser snapshot -i
@@ -327,6 +361,7 @@ agent-browser snapshot -i  # Fresh snapshot for new page
 ```
 
 ### Parallel Browser Sessions
+
 ```bash
 # Terminal 1
 agent-browser --session scraper1 open https://site-a.com
@@ -338,6 +373,7 @@ agent-browser --session scraper2 snapshot -i
 ```
 
 ### Mock API Response
+
 ```bash
 agent-browser network route "**/api/users" --body '[{"id":1,"name":"Mock User"}]'
 agent-browser open https://example.com  # App sees mocked data
@@ -345,6 +381,7 @@ agent-browser network unroute "**/api/users"
 ```
 
 ### Handle File Downloads
+
 ```bash
 agent-browser open https://example.com/downloads
 agent-browser snapshot -i
@@ -367,10 +404,10 @@ Default timeout: 10 seconds (Playwright default is 30s). Commands will fail afte
 
 ## Browser Support
 
-| Platform | Binary | Fallback |
-|----------|--------|----------|
-| macOS ARM64 | Native Rust | Node.js |
-| macOS x64 | Native Rust | Node.js |
-| Linux ARM64 | Native Rust | Node.js |
-| Linux x64 | Native Rust | Node.js |
-| Windows | - | Node.js |
+| Platform    | Binary      | Fallback |
+| ----------- | ----------- | -------- |
+| macOS ARM64 | Native Rust | Node.js  |
+| macOS x64   | Native Rust | Node.js  |
+| Linux ARM64 | Native Rust | Node.js  |
+| Linux x64   | Native Rust | Node.js  |
+| Windows     | -           | Node.js  |

package/dist/template/.opencode/skill/agent-teams/SKILL.md

@@ -6,11 +6,22 @@ description: >
   Covers team configuration, task distribution, coordination patterns, and best practices.
 version: "1.0.0"
 license: MIT
+tags: [agent-coordination, workflow]
+dependencies: []
 ---
 
 # Agent Teams - Multi-Agent Team Coordination
 
-Coordinate multiple agents working as a team under a lead agent. Unlike subagents (fire-and-forget), teams enable continuous coordination, shared context, and dynamic task reassignment.
+## When to Use
+
+- Parallel research, review, or competing approaches that need coordination
+- Tasks benefit from shared findings and a lead coordinating teammates
+
+## When NOT to Use
+
+- Single-agent tasks or tightly coupled edits where coordination overhead is wasteful
+- Simple parallel work that can use fire-and-forget subagents instead
+
 
 ## Overview
 

package/dist/template/.opencode/skill/augment-context-engine/SKILL.md

@@ -1,11 +1,21 @@
 ---
 name: augment-context-engine
 description: Semantic codebase search via Augment Context Engine MCP. Use when you need to understand code relationships, find relevant implementations, or explore unfamiliar codebases beyond keyword matching.
+version: 1.0.0
+tags: [research, context]
+dependencies: []
 ---
 
 # Augment Context Engine (MCP)
 
-Semantic code search powered by Augment's Context Engine. Unlike grep (text matching), this understands code meaning, relationships, and cross-file dependencies.
+## When to Use
+
+- When you need semantic search to understand code relationships or find implementations beyond keyword matching.
+
+## When NOT to Use
+
+- When exact string matching or known file paths can be handled by grep/read/LSP locally.
+
 
 ## Available Tools