reveal-feedback_skill

Overview

This skill connects your Reveal account to manage product feedback, review tasks, sentiment insights, submissions, notifications, and webhooks. It provides quick dashboard checks, detailed AI-aggregated insights, and full lifecycle control over user-testing tasks and notifications. Use it to turn reviewer videos and transcripts into actionable reports and to automate event delivery via webhooks.

How this skill works

The skill calls Reveal REST endpoints using an API key provided via environment variable and a configurable base URL. It lists products, fetches analytics and AI insights, reads individual submissions, creates or updates review tasks, manages notifications, and registers webhooks. All responses are forwarded exactly as returned by the API; the skill surfaces errors like authentication failures and missing products with clear remediation steps.

When to use it

• Get a quick dashboard summary of products, active tasks, and unread notifications
• Request AI-aggregated feedback for a product (top issues, positives, sentiment)
• Inspect individual review submissions, transcripts, and analyzed issues
• Create or update user-testing review tasks for recruiting reviewers
• Register or list webhooks to receive real-time events from Reveal

Best practices

• Ensure REVEAL_API_KEY is set and valid; a 401 indicates an invalid or expired key
• List products first if the skill cannot match a product name in your request
• When creating tasks, confirm title, objective, steps, and reviewer count before submission
• Do not share or log your API key; store webhook signing secrets securely
• Rely on API-returned data only—avoid fabricating or inferring feedback details

Example use cases

• Summary: show product count, active review tasks and recent unread notifications
• Insights: fetch sentiment breakdown and top issues for Product X to prioritize fixes
• Submissions: read the latest 5 submissions for a task and view transcript previews
• Task creation: build a new review task with instructions and required reviewer count
• Webhook setup: register an endpoint to receive review.submitted and review.analyzed events