# Send Reveal Product Feedback to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "reveal-feedback", "name": "Reveal Product Feedback", "source": "tencent", "type": "skill", "category": "数据分析", "sourceUrl": "https://clawhub.ai/tolulopeayo/reveal-feedback", "canonicalUrl": "https://clawhub.ai/tolulopeayo/reveal-feedback", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/reveal-feedback", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=reveal-feedback", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/api-reference.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/reveal-feedback" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/reveal-feedback", "downloadUrl": "https://openagent3.xyz/downloads/reveal-feedback", "agentUrl": "https://openagent3.xyz/skills/reveal-feedback/agent", "manifestUrl": "https://openagent3.xyz/skills/reveal-feedback/agent.json", "briefUrl": "https://openagent3.xyz/skills/reveal-feedback/agent.md" } } ``` ## Documentation ### Reveal Feedback Infrastructure Reveal is a universal feedback platform where human reviewers screen-record themselves using products and provide AI-analyzed feedback. This skill connects to the Reveal REST API to manage the full feedback lifecycle. ### Authentication All API calls require the REVEAL_API_KEY environment variable. The key is a vendor API key generated from the Reveal dashboard under Settings → API Keys. Every request uses this header: Authorization: Bearer $REVEAL_API_KEY Base URL: https://www.testreveal.ai/api/v1 (Override with REVEAL_BASE_URL env var if set.) ### 1. Check dashboard overview Fetch products, active review tasks, and unread notifications to give the user a quick status update. Steps: GET /products to list vendor products GET /review-tasks?status=active to list active tasks GET /notifications?unread=true&limit=5 to get unread notifications Summarize: product count, active tasks with submission progress, and recent notifications ### 2. Get feedback insights for a product Fetch AI-aggregated insights: top issues, top positives, sentiment distribution, and suggestions. Steps: GET /products to find the product ID matching the user's request GET /insights/{productId} to get aggregated insights Present: sentiment breakdown, top issues ranked by frequency, top positives, unique issue count ### 3. Get product analytics Fetch quantitative metrics for a product. Steps: GET /products/{productId}/analytics Present: total submissions, analyzed count, average completion rate, sentiment distribution, top issues, top positives ### 4. View review submissions Get individual review submissions with transcripts, AI analysis, sentiment, and issue counts. Steps: GET /review-tasks?status=active&limit=5 to find the relevant task (or use a task ID if provided) GET /review-tasks/{taskId}/submissions to get all submissions For each submission, present: status, sentiment, issue count, positive count, transcript preview ### 5. Create a review task Create a new user-testing task so reviewers can test a product. Steps: GET /products to find the product matching the user's description Extract from the user's message: title, objective, steps, feedback focus, reviewer count POST /review-tasks with body: { "title": "extracted title", "productId": "matched product ID", "requiredReviewers": 5, "instructions": { "objective": "what the reviewer should accomplish", "steps": "step-by-step instructions", "feedback": "what feedback to focus on" } } Confirm creation with task ID and details ### 6. Update a review task Close, pause, or modify an existing review task. Steps: PATCH /review-tasks/{taskId} with fields to update (status, title, description, requiredReviewers) Confirm the update ### 7. List products Show all products registered on the vendor's Reveal account. Steps: GET /products?limit=50 Present each product: name, category, platform support (web/mobile), website ### 8. Get notifications Check for new activity on Reveal. Steps: GET /notifications?unread=true&limit=20 Present notification messages with timestamps If user says to mark as read: PATCH /notifications with {"markAllRead": true} ### 9. Register a webhook Set up real-time event notifications. Steps: POST /webhooks with body: { "url": "https://user-provided-url", "events": ["review.submitted", "review.analyzed", "task.completed", "video.generated"] } Return the webhook ID and signing secret. Instruct user to store the secret securely. ### 10. List webhooks Steps: GET /webhooks Present each webhook: URL, subscribed events, active status ### Response format All API responses follow this structure: Success: { "data": { ... } } Error: { "error": { "code": "ERROR_CODE", "message": "description" } } ### Guardrails Never expose or log the API key in responses to the user If an API call fails with 401, tell the user their API key may be invalid or expired If a product is not found, suggest listing products first When creating review tasks, always confirm the details with the user before sending the POST Do not fabricate feedback data — only report what the API returns ## Trust - Source: tencent - Verification: Indexed source record - Publisher: tolulopeayo - Version: 1.0.1 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-23T16:43:11.935Z - Expires at: 2026-04-30T16:43:11.935Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/reveal-feedback) - [Send to Agent page](https://openagent3.xyz/skills/reveal-feedback/agent) - [JSON manifest](https://openagent3.xyz/skills/reveal-feedback/agent.json) - [Markdown brief](https://openagent3.xyz/skills/reveal-feedback/agent.md) - [Download page](https://openagent3.xyz/downloads/reveal-feedback)