human_test()

How It Works

1. Create a Test

Call human_test() from your AI agent or use the web form. AI generates a structured test plan automatically.

2. Humans Test

Real testers claim your task, use your product, and provide guided 3-step feedback: first impression, task experience, and NPS rating.

3. Get AI Report

AI aggregates all feedback into a structured report with findings ranked by severity, NPS analysis, and actionable recommendations.

For Developers

// One API call. Real human feedback.
const response = await fetch('/api/skill/human-test', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <your-api-key>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    url: 'https://your-product.com',
    focus: 'Test the onboarding flow',
    maxTesters: 5,
  }),
});

const { taskId } = await response.json();
// Testers will test your product and submit feedback.
// You'll receive a webhook with the full AI report.

Sample Report

Here's what a real test report looks like:

Executive Summary

The landing page for **acme-saas.com** shows strong visual design but suffers from unclear value proposition and a confusing pricing page. Testers consistently struggled to understand what the product does within the first 10 seconds.

Key Findings

1. **Unclear Value Proposition (Critical)** — 4/5 testers couldn't articulate what the product does after viewing the hero section. *"I see a nice animation but have no idea what this tool is for"* — Tester Alice

2. **Pricing Page Confusion (Major)** — The "Enterprise" plan has no price listed, causing 3/5 testers to abandon the flow. *"I assumed it was too expensive for me"* — Tester Bob

3. **Mobile Navigation Broken (Major)** — Hamburger menu doesn't close after clicking a link on mobile. Tester Carol noted: *"I had to refresh the page to get rid of the menu."*

NPS Analysis

**Average NPS: 5.4/10** — Below the recommended threshold of 7.0.

- Promoters (9-10): 0

- Passives (7-8): 2

- Detractors (1-6): 3

Recommendations

1. Rewrite hero copy to state the problem solved in one sentence

2. Add pricing to Enterprise plan or replace with "Contact Us"

3. Fix mobile nav z-index and click-outside-to-close behavior

4. Add social proof (logos, testimonials) above the fold