stably-sdk-rules

Document best practices for Stably AI Playwright tests using aiAssert and agent.act.

37|12|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/exiao/skills --skill stably-sdk-rules-exiao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stably-sdk-rules
Source: https://github.com/exiao/skills/tree/main/stably-sdk-rules
Command: npx skills add https://github.com/exiao/skills --skill stably-sdk-rules-exiao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @playwright/test, @stablyai/playwright-test, @stablyai/email, and includes references (resource) components.

What problem does it solve?

This Skill provides clear guidelines and best practices for writing robust and efficient Playwright tests using Stably AI's SDKs, ensuring optimal use of AI assertions and actions.

Core Features & Use Cases

  • AI Assertion Guidance: Learn when to use aiAssert versus raw Playwright assertions.
  • Action Orchestration: Understand the appropriate use of agent.act() for complex or brittle interactions.
  • Data Extraction: Master page.extract() and locator.extract() for converting visual data to structured formats.
  • Semantic Locators: Utilize page.getLocatorsByAI() for more resilient element selection.
  • Email Handling: Implement reliable email verification flows with the Inbox utility.
  • Use Case: When developing automated UI tests for a web application, developers can consult this Skill to ensure they are leveraging AI capabilities effectively for visual validation and dynamic element interactions, while prioritizing performance with standard Playwright methods for deterministic tasks.

Quick Start

Consult the stably-sdk-rules skill for guidance on using aiAssert versus raw Playwright for your test assertions.

Frequently Asked Questions about stably-sdk-rules

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

FAQPage Schema
How do I use AI assertions in Playwright tests effectively?

Use `aiAssert` for visual validation and complex dynamic content, while reserving raw Playwright methods for deterministic actions to ensure reliability and optimal performance.

When should I use agent.act versus raw Playwright commands?

Use `agent.act()` for complex or brittle interactions that are difficult to target with standard selectors, whereas raw Playwright commands should handle deterministic actions to prioritize test performance and reliability.

How do I extract visual data to structured formats using Playwright AI?

You can extract visual data to structured formats using the `page.extract()` and `locator.extract()` methods provided by the Stably AI Playwright SDK within your bloom-tests.

Do I need specific npm packages to run Stably AI Playwright tests?

Yes, running Stably AI Playwright tests requires installing specific npm packages including `@playwright/test`, `@stablyai/playwright-test`, and `@stablyai/email`, alongside configuring necessary environment variables for setup.

How can I find resilient web element locators using AI in automated testing?

You can find resilient web element locators using AI by utilizing the `page.getLocatorsByAI()` method, which provides semantic element selection for more robust automated UI tests.

What is the best way to handle email verification flows in automated UI testing?

The best way to handle email verification flows in automated UI testing is implementing the `Inbox` utility from the `@stablyai/email` package to ensure reliable email validation within your test scripts.