# shiplight

A router skill for Shiplight testing and QA. It takes a subcommand and hands it to the matching workflow, and only fires when you name shiplight.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 508 installs · ★ 2
- Author: ShiplightAI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ShiplightAI/agent-skills-v2/tree/HEAD/shiplight/SKILL.md
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/skills/shiplight

## What it does

The skill is a dispatcher. You type `/shiplight` with a subcommand, and it matches the argument against a table and opens the right instruction file under `references/`. The subcommands are `init`, `setup-test-auth`, `update`, `create-yaml-tests`, `create-agent-verification`, `cover`, `fix`, `verify`, `review`, `ci`, `cloud`, `support` and `help`.

Matching does not stop at the first word. Synonyms run to several words, so the router looks for the longest phrase and passes whatever is left to the subcommand as context. Type "create a yaml test for login" and it goes to `create-yaml-tests` with `for login` carried along.

The description is gated on purpose: without the word shiplight the skill ignores a plain "write a test". Before any subcommand runs, a shared step in `references/_shared/update-check.md` refreshes the skill daily and checks the `shiplightai` CLI version. A CLI behind the published release halts the run and offers an upgrade. And `init` will not touch a non-empty project on its own — it asks first.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ShiplightAI/agent-skills-v2 --skill shiplight -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/shiplight/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/shiplight/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ShiplightAI/agent-skills-v2 --skill shiplight -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/shiplight/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ShiplightAI/agent-skills-v2 --skill shiplight -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/shiplight/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ShiplightAI/agent-skills-v2 shiplight
```

2. **Manually: put the files in place**
- File: `.github/skills/shiplight/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ShiplightAI/agent-skills-v2 --skill shiplight -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ShiplightAI/agent-skills-v2 --path shiplight
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/shiplight/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ShiplightAI/agent-skills-v2 --skill shiplight -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ShiplightAI/agent-skills-v2/tree/HEAD/shiplight/SKILL.md

## When to use it
- route QA work through subcommands instead of one long prompt
- write deterministic YAML E2E tests from a spec
- set up login for the app under test and save browser state
- reproduce failing tests and repair them after a product change
- read run results and analytics from Shiplight Cloud

## Example prompts
- /shiplight cover checkout flow
- /shiplight create a yaml test for login
- /shiplight fix — show me the failing tests

## Similar
- [improve-codebase-architecture](https://affpapa.org/en/nevibecode/skills/improve-codebase-architecture.md) — skill · 1163035 installs
- [design-taste-frontend](https://affpapa.org/en/nevibecode/skills/design-taste-frontend.md) — skill · 678700 installs
- [tdd](https://affpapa.org/en/nevibecode/skills/tdd.md) — skill · 1141062 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [agent-browser](https://affpapa.org/en/nevibecode/skills/vercel-labs-agent-browser.md) — skill · 1200000 installs
- [prototype](https://affpapa.org/en/nevibecode/skills/prototype.md) — skill · 986201 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md