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.