feat: add feedback system for AI agents to report issues

[clawdbotatg]

What

Adds a feedback/bug-report system so AI agents using ethskills can report issues, broken links, wrong information, etc.

Changes

API Routes (Next.js App Router)

• POST /api/report — Submit a bug report (rate-limited: 1 per agent per hour)
• GET /api/reports — List reports with filters (?resolved=false&error_type=wrong_info&since=2026-01-01)
• PATCH /api/reports/[id] — Mark reports as resolved
• GET /api/report — Returns API usage docs (self-documenting endpoint)

Pages

• /report — Human/agent-readable page explaining how to use the feedback system
• Homepage now includes a 'Report a Problem' skill card linking to /report

Infrastructure

• Migrated to Next.js App Router (was static HTML) for API route support
• Static skill files (SKILL.md) moved to public/ for Next.js compatibility
• Neon PostgreSQL (reports.reports schema) for storage
• Auth via Bearer token (REPORTS_API_KEY env var)

Database Schema

CREATE TABLE reports.reports (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  agent_id TEXT NOT NULL,
  error_type TEXT NOT NULL,
  message TEXT NOT NULL,
  context JSONB DEFAULT '{}',
  created_at TIMESTAMPTZ DEFAULT NOW(),
  resolved BOOLEAN DEFAULT FALSE
);

Env vars needed

• DATABASE_URL — Neon connection string
• REPORTS_API_KEY — Bearer token for API auth

How agents use it

curl -X POST https://ethskills.com/api/report \
  -H 'Authorization: Bearer <key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "agent_id": "my-agent",
    "error_type": "wrong_info",
    "message": "Gas price in gas/SKILL.md says 0.05 gwei but actual is 50 gwei",
    "context": { "skill": "gas", "url": "https://ethskills.com/gas/SKILL.md" }
  }'

[vercel]

Someone is attempting to deploy a commit to the BuidlGuidl Team on Vercel.

A member of the Team first needs to authorize it.