Skill

test-conventions

Testing conventions and configuration reference. Use when agents or commands need config schema, severity classification, report templates, or credential rules for browser testing.

npx claudepluginhub kinginyellows/yellow-plugins --plugin yellow-browser-test

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Reference conventions for the yellow-browser-test plugin's testing workflow.

SKILL.md

Similar Skills

qa-use

Automates E2E testing and browser interactions with qa-use CLI. Create sessions, navigate pages, snapshot DOM for element refs, perform clicks/fills, and debug test failures.

8 files1 tool

qa-use

candid-chrome-qa

Drives Chrome browser sessions against running web apps to detect bugs, UX issues, accessibility violations, performance problems, and copy errors, outputting structured JSON findings for QA passes, smoke tests, or audits.

candid

scoutqa-test

29.8k

Runs ScoutQA CLI for AI-powered exploratory testing of web apps, including smoke tests, accessibility audits, login flows, and e-commerce validation. Proactive after feature implementation.

awesome-copilot-refactor

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitFeb 27, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Test Conventions

What It Does

Reference conventions for the yellow-browser-test plugin's testing workflow. Defines the config schema, report format, severity levels, and safety rules.

When to Use

Use when yellow-browser-test commands or agents need the config schema, severity classification, or credential handling rules.

Usage

This skill is not user-invokable. It provides shared context for the yellow-browser-test plugin.

Config Schema

Config is stored at .claude/yellow-browser-test.local.md as YAML frontmatter + markdown notes.

---
schema: 1
generated: '2026-02-13T10:30:00Z'
devServer:
  command: 'npm run dev'
  port: 3000
  baseURL: 'http://localhost:3000'
  readyTimeout: 60
  readyPath: '/'
auth:
  type: 'email-password'
  loginPath: '/login'
  credentials:
    email: '$BROWSER_TEST_EMAIL'
    password: '$BROWSER_TEST_PASSWORD'
  formFields:
    email: 'email'
    password: 'password'
routes:
  - path: '/dashboard'
    name: 'Dashboard'
    auth: true
---

Required fields: schema, devServer.command, devServer.baseURL

Severity Classification

Severity	Criteria	Example
critical	App crashes, data loss, security hole	Unhandled exception on form submit
major	Feature broken, console error, blank section	Settings page renders empty
minor	Slow load, UI glitch, non-blocking error	Button misaligned, 5s load time
cosmetic	Visual imperfection, typo	Font inconsistency, extra whitespace

Credential Handling Rules

Never store actual credentials — config references env var NAMES only ($BROWSER_TEST_EMAIL)
Auth state file — .claude/browser-test-auth.json must be gitignored
Missing vars — If env vars are not set, error with: "Set {VAR_NAME} in your environment or .env.local"
PID file — .claude/browser-test-server.pid must be gitignored
Env var naming — Use BROWSER_TEST_* prefix for all test credentials (e.g., BROWSER_TEST_EMAIL, BROWSER_TEST_PASSWORD)
Never log credentials — Mask credential values in reports with ***
Auth state expiry — If tests fail with auth errors, delete .claude/browser-test-auth.json and re-run setup to refresh auth state

Safe Exploration Rules

During autonomous exploration, the test-runner agent MUST:

Follow safety rules from agent-browser-patterns skill
Limit depth — Max 3 levels from starting page
Limit time — Max 10 minutes per exploration session
Save incrementally — Write partial results every 5 routes to prevent data loss

Report Template

Reports are written to test-reports/YYYY-MM-DD-HH-MM.md. See test-reporter agent for full template and GitHub issue creation flow.

Security: ALWAYS use AskUserQuestion before creating GitHub issues. Never auto-create. Warn that screenshots may contain sensitive data.