qa-new-flow

Creates browser QA flow spec files from a Markdown template with YAML frontmatter.

12.1k|1.5k|Updated Jul 12, 2023
One-click install
npx skills add https://github.com/elie222/inbox-zero --skill qa-new-flow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qa-new-flow
Source: https://github.com/elie222/inbox-zero/tree/main/.claude/skills/qa-new-flow
Command: npx skills add https://github.com/elie222/inbox-zero --skill qa-new-flow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually authoring new browser QA flow specifications is repetitive and error-prone, especially when every file must follow a consistent template with correctly formatted YAML frontmatter. This Skill scaffolds a new flow file in qa/browser-flows with the right structure, slug validation, and optional fields handled automatically.

Core Features & Use Cases

  • Template-Based Scaffolding: Generates qa/browser-flows/<id>.md from qa/browser-flows/_template.md with frontmatter populated from CLI-style arguments.
  • Slug and Field Validation: Enforces URL-safe lowercase-dash IDs, requires id, title, and resources, and prompts for missing values before writing.
  • Optional Metadata Handling: Supports parallel_safe, conflicts_with (always serialized as a YAML list), goal, preconditions, and cleanup sections.
  • Use Case: A QA engineer needs a new flow verifying conversation rules. They run the command with --id=conversation-rules-check --title="Conversation rules" --resources=conversation-rules --goal="Verify rules apply" and get a ready-to-edit spec file without touching the template manually.

Quick Start

Ask the assistant to create a new QA flow with id "login-check", title "Login flow", resources "auth", and a goal describing what the flow verifies.

Frequently Asked Questions about qa-new-flow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new browser QA flow spec file?▼

Invoke the skill with arguments like --id=flow-id --title="Short title" --resources=assistant-settings and optionally --goal, --preconditions, and --cleanup. It generates qa/browser-flows/<id>.md from the template with the frontmatter filled in.

What arguments are required to scaffold a QA flow file?▼

The id, title, and resources fields are required. If any are missing, the skill asks for them before proceeding. Optional flags include --parallel-safe, --conflicts-with, --goal, --preconditions, and --cleanup.

What naming rules apply to the QA flow id?▼

The id must be a URL-safe slug containing only lowercase letters, numbers, and dashes, and it must match the generated filename. The skill validates this before creating the file in qa/browser-flows.

How are conflicting QA flows declared in the frontmatter?▼

Pass --conflicts-with with comma-separated flow ids. The skill always serializes conflicts_with as a YAML list, even when only a single id is provided, so parallel execution tooling can parse it consistently.

What happens if the QA flow file already exists?▼

The skill does not overwrite an existing flow file without explicit confirmation from the user. This prevents accidental loss of manually edited flow specifications.