test-ask-tool

Tests the blocking ask tool question flyout across select, text, and skip shapes.

10|1|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/catalystctl/catcode --skill test-ask-tool-catalystctl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-ask-tool
Source: https://github.com/catalystctl/catcode/tree/main/.catalyst-code/skills/test-ask-tool
Command: npx skills add https://github.com/catalystctl/catcode --skill test-ask-tool-catalystctl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Verifying that an interactive question flyout works end-to-end is tedious and error-prone when done ad hoc. This Skill provides a repeatable test matrix that exercises every shape of the ask tool in a single call, so regressions in the schema, dispatch, or UI rendering are caught quickly. ## Core Features & Use Cases - Single-call test matrix: Sends one ask call containing five questions covering select, allowCustom, required text, optional text, and a single-option edge case. - Answer verification: Reports per-question results keyed by id, confirming required questions return answers and optional ones can be skipped. - Abort path testing: Verifies that dismissing the flyout ends the turn cleanly without orphaned tool calls. - Use Case: After modifying the ask schema in core/src/tools.rs or the web AskPrompt component, run this Skill to confirm the flyout still renders and returns answers correctly. ## Quick Start Ask the agent to test the ask tool and verify the question flyout renders all question types correctly.

Frequently Asked Questions about test-ask-tool

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

FAQPage Schema
How do I test a blocking user-question tool in an agent loop?

Send a single ask call containing a matrix of question shapes: required select, allowCustom select, required text, optional text, and a single-option select. The tool blocks until the user answers, then verify each answer returns keyed by its question id.

How to test skip and abort behavior in a question flyout?

Include an optional question with required set to false so the user can skip it, and separately dismiss the entire flyout to test the abort path. Confirm the turn exits cleanly and no orphaned tool call remains for the sanitizer to clean up.

What question types does the ask tool support?

The ask tool supports select questions with multiple options, select with allowCustom for free-form answers, and text questions with placeholders. Each question can be marked required or optional, and ids must be unique or validation rejects them.

Can the ask tool be tested in an automated unattended context?

No, the ask tool blocks the agent loop until a user answers, skips, or aborts, so it cannot self-answer in automated runs. For unattended validation, use the schema validator validate_ask_questions in core/src/tools.rs instead.

Why does ask question validation reject my input?

Validation rejects duplicate question ids, empty option lists, and invalid question types. Use distinct stable id values for every question and ensure each select question has at least one option.