guide-interaction

Drives state-based interactive guide workflows using guide MCP tools.

2.9k|733|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/zts212653/clowder-ai --skill guide-interaction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: guide-interaction
Source: https://github.com/zts212653/clowder-ai/tree/main/cat-cafe-skills/guide-interaction
Command: npx skills add https://github.com/zts212653/clowder-ai --skill guide-interaction

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When users ask how to configure or operate a feature, plain text answers are often insufficient, yet blindly launching interactive guides for every keyword creates noise. This Skill resolves that tension by deciding when a step-by-step interactive guide is appropriate and by driving the full guide lifecycle based on system-injected states.

Core Features & Use Cases

  • State-Driven Responses: Reacts to injected states (Guide Matched, Pending, Selection, Active, Completed) instead of re-matching guides from raw chat text.
  • Guide Lifecycle Control: Uses MCP tools to fetch available guides, send interactive selection cards, persist guide state, launch the frontend overlay, and control an active guide (exit or skip).
  • Judgment Before Action: Distinguishes between users who need a quick explanation and users who need hands-on step-by-step guidance, avoiding fake or duplicate guide offers.
  • Use Case: A user asks "how do I configure this feature?" The assistant checks available guides, offers an interactive card with start/preview/skip options, launches the overlay on confirmation, and handles exit requests mid-guide.

Quick Start

When the user asks how to operate a feature, check available guides with the guide MCP tools and offer an interactive guide card instead of a long text tutorial.

Frequently Asked Questions about guide-interaction

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

FAQPage Schema
How do I trigger an interactive guide when a user asks how to use a feature?

First judge whether a short explanation suffices; if step-by-step help fits, call cat_cafe_get_available_guides to list candidates, pick the best match, then send a selection card with cat_cafe_create_rich_block and persist the offered state.

What MCP tools control the guide lifecycle?

Five tools are used: cat_cafe_get_available_guides lists guides, cat_cafe_update_guide_state persists status, cat_cafe_create_rich_block sends selection cards, cat_cafe_start_guide launches the overlay, and cat_cafe_guide_control exits or skips an active guide.

Should the assistant match guides from keywords in the chat text?

No. The routing layer no longer auto-creates guide offers from raw messages, and the assistant must not invent guides from keywords. It only acts on system-injected states or after explicitly fetching the available guide catalog.

What happens when a guide is already active or completed?

During Guide Active, only answer questions related to the current step and use guide_control to exit on request. After Completed or Cancelled, resume normal conversation without re-sending cards or repeatedly asking about the guide.

When should I not use interactive guides?

Avoid guides for casual chat, code implementation questions, or conceptual discussions with no procedural need. If a brief direct answer solves the user's question, respond directly without creating any guide offer.