nova-act-usability
AI-orchestrated usability testing using Amazon Nova Act. The agent generates personas, runs tests to collect raw data, interprets responses to determine goal achievement, and generates HTML reports. Tests real user workflows (booking, checkout, posting) with safety guardrails. Use when asked to "test website usability", "run usability test", "generate usability report", "evaluate user experience", "test checkout flow", "test booking process", or "analyze website UX".
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/adityak6798/website-usability-test-nova-actNova 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 |
| 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:
- Run the test script → collect raw data
- Read JSON → interpret each
raw_response - Set
goal_achievedandoverall_success - 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 responses | Script |
| 3. Interpret | Read JSON, determine goal_achieved for each step | Agent |
| 4. Report | Generate HTML report with interpreted results | Agent |
⚠️ The script does NOT interpret responses or generate the final report. You must do phases 3-4.
🎯 Recommended: AI Agent Generates Personas
You're already an AI (Claude) - use your intelligence to generate contextual personas!
import subprocess
import os
import sys
import json
import tempfile
# Step 1: Check dependencies
try:
import nova_act
print("✅ Dependencies ready")
except ImportError:
print("📦 Dependencies not installed. Please run:")
print(" pip3 install nova-act pydantic playwright")
print(" playwright install chromium")
sys.exit(1)
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-adityak6798-website-usability-test-nova-act": {
"enabled": true,
"auto_update": true
}
}
}