true-skills: Instructions file for Kiro

Katalon Playwright Execute

Use this skill when the user asks to execute a Playwright script/suite and send results to Katalon True Platform. The workflow is not complete until local execution finishes, report artifacts are collected, and upload is either verified or clearly blocked.

Execution Workflow

+------------------+ --> +------------------+ --> +------------------+
| Resolve target   |     | Preflight repo   |     | Configure report |
+------------------+     +------------------+     +------------------+
                                                        |
                                                        v
+------------------+ <-- +------------------+ <-- +------------------+
| Verify Platform  |     | Upload report    |     | Run Playwright   |
+------------------+     +------------------+     +------------------+

Required Context

Resolve or ask for only missing required values:

• Playwright target: spec file, grep, project, package script, suite command, or user-provided command.
• Repository/root directory that contains package.json and Playwright config.
• Katalon Platform project ID. Use Katalon MCP list_projects when available.
• Katalon API key from a secure source such as KATALON_API_KEY; check whether it is already available before asking.
• Platform base URL only when non-default or when the project uses QA/prod custom domains.
• Whether the agent may modify Playwright config/package files if the Katalon reporter is missing.

Treat the human as a tool: ask concise questions when target, credentials, project, or permission cannot be resolved safely. Never ask the user to paste secrets into normal chat when a secure secret mechanism or environment variable can be used.

Preflight

Before running:

• Inspect the repository for package.json, playwright.config.*, @playwright/test, existing reporters, package manager lockfiles, and scripts.
• Verify Node.js is version 18 or newer when possible.
• Check for KATALON_API_KEY in the current process environment or the repo's approved secret mechanism before composing any upload command.
• If KATALON_API_KEY is missing, stop before execution/upload and ask the user to provide it through a secure environment variable or secret mechanism.
• Run dependency installation only when the repo convention is clear and the user has allowed dependency changes.
• Confirm @katalon/playwright-reporter is installed or can be installed.
• Verify a deterministic report output directory, preferably ./reports or the repo's existing Katalon report directory.
• Build commands with secrets redacted in user-facing output.