trim-flows

Organize and track user verification flows in .trim/flows.json with Playwright test export.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/yoshisada/ai-repo-template --skill trim-flows
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trim-flows
Source: https://github.com/yoshisada/ai-repo-template/tree/main/plugin-trim/skills/trim-flows
Command: npx skills add https://github.com/yoshisada/ai-repo-template --skill trim-flows

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Organizes and tracks user verification flows for QA and automation, reducing manual coordination and ensuring testability across the lifecycle.

Core Features & Use Cases

  • Define, list, sync, and export tests from flows stored in .trim/flows.json.
  • Map each step to a UI page, component, and Penpot frame for visual verification and traceability.
  • Generate Playwright test stubs from flows to accelerate automation and ensure QA readiness.

Quick Start

Run /trim:trim-flows add <name> and describe the flow steps to begin tracking.

Frequently Asked Questions about trim-flows

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

FAQPage Schema
How do I generate Playwright test stubs from QA flows?

Playwright test stubs are generated by defining flow steps with actions, targets, and pages in a .trim/flows.json file, then exporting the structured data. This accelerates automation by providing ready-to-use test scaffolding from tracked user verification flows.

What's the best way to track QA verification flows for automation?

QA verification flows are tracked by storing structured data in a .trim/flows.json file, ensuring each flow has a name, description, and detailed steps. This reduces manual coordination and ensures testability across the lifecycle.

Can I map test flows to UI pages and Penpot frames for traceability?

Test flows can be mapped to UI pages, components, and Penpot frames for visual verification and traceability. Each step in the .trim/flows.json file supports page-level mapping to connect automated tests with design artifacts.

Does trim-flows require external dependencies to manage test flows?

Managing test flows with trim-flows requires no external dependencies. It organizes and tracks user verification flows independently, relying solely on the local .trim/flows.json file to define, list, sync, and export data.

What format is used to store and sync automation flow data?

Automation flow data is stored and synced as human-readable JSON within a .trim/flows.json file. This format ensures each flow contains a name, description, and steps with action, target, and page attributes.

How do I add a new user verification flow for testing?

New user verification flows are added by running the add command with a flow name, then describing the flow steps. The system organizes this input into structured data for QA tracking and Playwright export.