nova-act-usability

# Nova Act Usability Testing v1.0.2

**AI-orchestrated** usability testing with digital twin personas powered by Amazon Nova Act.

## ⚠️ Prerequisites & Credentials

**This skill requires an Amazon Nova Act API key.**

| Requirement | Details |
|-------------|---------|
| **API Key** | Nova Act API key from [AWS Console](https://console.aws.amazon.com/) |
| **Config Location** | `~/.openclaw/config/nova-act.json` |
| **Format** | `{"apiKey": "your-nova-act-api-key-here"}` |
| **Dependencies** | `pip3 install nova-act pydantic playwright` |
| **Browser** | `playwright install chromium` (~300MB download) |

## 🔒 Data & Privacy Notice

**What this skill accesses:**
- **Reads:** `~/.openclaw/config/nova-act.json` (your API key)
- **Writes:** `./nova_act_logs/` (trace files with screenshots), `./test_results_adaptive.json`, `./nova_act_usability_report.html`

**What trace files contain:**
- Screenshots of every page visited
- Full page content (HTML, text)
- Browser actions and AI decisions

**Recommendations:**
- Run tests only on **non-production** or **test environments**
- Be aware traces may capture **PII or sensitive data** visible on tested pages
- Review/delete trace files after use if they contain sensitive content
- Consider running in a **sandboxed environment** (container/VM) for untrusted sites

---

## Features

**Agent-Driven Interpretation**: The script no longer interprets responses. YOU (the agent) must:
1. Run the test script → collect raw data
2. Read JSON → interpret each `raw_response` 
3. Set `goal_achieved` and `overall_success`
4. Generate the report

No hardcoded regex. No extra API calls. The agent doing the work is already running.

## Quick Start (For AI Agents)

**When a user asks to test a website, YOU (the AI agent) must complete ALL 4 phases:**

| Phase | What Happens | Who Does It |
|-------|--------------|-------------|
| 1. Setup | Generate personas, run test script | Agent + Script |
| 2. Collect | Script captures raw Nova Act respon...

# Nova Act Usability Testing Skill v1.0.2

AI-orchestrated usability testing for websites using Amazon Nova Act browser automation.

## ⚠️ Prerequisites & Credentials

**This skill requires an Amazon Nova Act API key.**

| Requirement | Details |
|-------------|---------|
| **API Key** | Nova Act API key from [AWS Console](https://console.aws.amazon.com/) |
| **Config Location** | `~/.openclaw/config/nova-act.json` |
| **Format** | `{"apiKey": "your-nova-act-api-key-here"}` |

## 🔒 Data & Privacy Notice

**What this skill accesses:**
- **Reads:** `~/.openclaw/config/nova-act.json` (your API key)
- **Writes:** `./nova_act_logs/`, `./test_results_adaptive.json`, `./nova_act_usability_report.html`

**Trace files contain screenshots and full page content.** Run tests only on non-production environments. Traces may capture PII visible on tested pages.

---

## Features

🎯 **Agent-Driven Interpretation**: The script collects raw data, the AI agent (you) interprets responses and generates reports. No hardcoded regex, no extra API calls.

📊 **Three-Phase Flow**:
1. **Collect** - Script runs Nova Act, captures raw responses
2. **Interpret** - Agent reads JSON, determines goal achievement
3. **Report** - Agent generates HTML with accurate pass/fail status

## What It Does

- **Workflow Testing**: Tests complete user journeys (booking flights, checkout, posting) with safety guardrails
- **Adaptive Testing**: AI-driven browser automation that explores websites like a real user
- **Safety First**: Automatically stops before material impact (payment, posting, account creation)
- **Contextual Personas**: Analyzes your site and generates relevant user personas automatically
- **Realistic Test Cases**: Creates targeted test scenarios based on what your page actually offers (including full workflows)
- **Cookbook-Guided**: Loads best practices and safety guidelines automatically at test start
- **Comprehensive Reports**: Auto-generates HTML reports with detailed findings and sessi...