verify-setup

Category: Tools & Productivity | Uploader: opslane | Downloads: 0 | Version: v1.0（Latest）

One-time setup for /verify. Auto-detects dev server and indexes the app.

Changelog: Source: GitHub https://github.com/opslane/verify

Directory Structure

Current level: tree/main/skills/verify-setup/

📄 SKILL.md 1.6 KB

SKILL.md

---
name: verify-setup
description: One-time setup for /verify. Auto-detects dev server and indexes the app.
---

# /verify-setup

Run once before using /verify on a new project.

## Prerequisites

- Dev server running locally (any framework)
- Node.js 22+

## Steps

### 1. Run init

```bash
npx @opslane/verify init
```

This automatically:
1. Creates `.verify/` directory and updates `.gitignore`
2. Detects your dev server port from `package.json` and framework configs
3. Indexes your app's routes and selectors

### 2. Configure Playwright MCP

If not already installed:

```bash
claude mcp add playwright -- npx @playwright/mcp@latest --storage-state .verify/auth.json --isolated
```

Restart Claude Code after adding the MCP server.

**Note:** The `--storage-state` flag loads auth state from `.verify/auth.json`. The `--isolated` flag ensures Playwright uses that state instead of its own profile.

### 3. Verify setup worked

```bash
cat .verify/config.json
cat .verify/app.json | head -20
```

You should see your `baseUrl` in config and routes in `app.json`.

### 4. Troubleshooting

**"Dev server not running"** — Start your dev server and re-run `npx @opslane/verify init`.

**Wrong port detected** — Override with: `npx @opslane/verify init --base-url http://localhost:YOUR_PORT`

**Playwright MCP not found** — Run `claude mcp add playwright -- npx @playwright/mcp@latest --storage-state .verify/auth.json --isolated` and restart Claude Code.

**Auth expired during /verify** — Log into your app in the Playwright browser session, or provide credentials when prompted by `/verify`.

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

verify-setup

Directory Structure

SKILL.md

Report

Notice