ocs-chatbot-qa

Exercise deployed OCS chatbots via anonymous widgets and capture structured QA transcripts.

1|2|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/dimagi-internal/ace --skill ocs-chatbot-qa-dimagi-internal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ocs-chatbot-qa
Source: https://github.com/dimagi-internal/ace/tree/main/skills/ocs-chatbot-qa
Command: npx skills add https://github.com/dimagi-internal/ace --skill ocs-chatbot-qa-dimagi-internal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Testing deployed ACE OCS chatbots for Connect opportunities previously required manual interaction, ad-hoc note-taking, and inconsistent validation of response quality, leading to missed issues like timeouts, missing citations, or broken RAG for opp-specific content before launch or during production monitoring.

Core Features & Use Cases

  • Multi-Mode Testing: Supports three testing modes tailored to different lifecycle stages: a 3-prompt quick smoke test for post-setup Phase 5 validation, a full deep suite with opp-specific prompts for pre-launch QA, and a recurring monitor suite for Phase 6 production health checks.
  • Built-in Structural Validation: Automatically runs deterministic checks on every chatbot response to flag timeouts, error responses, and missing citations, with a 3-prompt circuit breaker to halt testing if the OCS instance is unhealthy.
  • Durable Transcript Capture: Writes machine-readable, structured transcripts to Google Drive that serve as direct input for the paired ocs-chatbot-eval skill, with support for resuming partial captures if the suite hits wall-clock limits or is interrupted.
  • Use Case: A product manager running a pre-launch check for a new focus-group opportunity can use deep mode to test both shared Connect workflow questions and opp-specific guidance questions, catching RAG misconfigurations before the chatbot goes live to frontline workers.

Quick Start

Use the ocs-chatbot-qa skill to run a full deep QA suite against your deployed ACE OCS chatbot for the 'malaria-itn-fgd' opportunity and capture a structured transcript for grading.

Frequently Asked Questions about ocs-chatbot-qa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate QA testing for deployed chatbots?

Automate QA testing for deployed chatbots by exercising the OCS instance via its anonymous widget to capture structured transcripts with built-in structural validation. This replaces manual interaction with deterministic checks for timeouts, error responses, and missing citations.

What is a chatbot smoke test for post-setup validation?

A chatbot smoke test for post-setup validation is a 3-prompt quick test that checks if a deployed OCS chatbot is healthy. It includes a circuit breaker that halts testing if the instance returns errors, ensuring the basic ACE lifecycle setup functions correctly.

How do I capture structured QA transcripts for LLM-as-judge grading?

Capture structured QA transcripts for LLM-as-judge grading by running a deep QA suite against the chatbot and writing the machine-readable results to durable Google Drive storage. These transcripts serve as direct input for downstream evaluation.

Can I resume a partial chatbot QA suite if it is interrupted?

Yes, you can resume a partial chatbot QA suite if it is interrupted. The testing framework supports partial capture resumability, allowing you to continue the suite execution if it hits wall-clock limits or stops before completion.

Does the chatbot QA testing support time-boxed suite execution?

Yes, chatbot QA testing supports time-boxed suite execution with per-prompt timeouts and circuit-breaker error handling. This ensures testing halts automatically for unhealthy OCS instances or slow responses, preventing indefinite hangs during monitoring.