interactive-guide

Guides users step-by-step through manual operations that AI cannot execute directly.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/kai-kou/gem-hunter --skill interactive-guide-kai-kou
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: interactive-guide
Source: https://github.com/kai-kou/gem-hunter/tree/main/.claude/skills/interactive-guide
Command: npx skills add https://github.com/kai-kou/gem-hunter --skill interactive-guide-kai-kou

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Some tasks—configuring third-party admin consoles, creating accounts, performing GUI operations on a local PC, entering 2FA codes or CAPTCHAs—cannot be executed by an AI agent because no CLI, API, or MCP path exists. This Skill structures those unavoidable manual steps into a low-friction interactive walkthrough instead of dumping a wall of instructions on the user. ## Core Features & Use Cases - Two-Gate Activation Check: Verifies that no CLI/API/MCP alternative exists and that the step genuinely requires the user's own hands before engaging, preventing the AI from offloading work it could do itself. - Step-by-Step Loop: Presents an overall summary (step count, prerequisites, expected outcome), then guides one step at a time with just-in-time research of current URLs and UI labels via WebFetch/WebSearch. - Completion Verification & Recovery: Requests screenshots only when errors would otherwise go undetected, and recovers from stuck states by re-researching the latest UI and re-presenting only the next action. - Use Case: A user needs to issue a Slack Bot Token from the admin console. The Skill confirms no API path exists, then walks the user through opening the app management page, setting scopes, and installing the app—one step at a time, verifying each before proceeding. ## Quick Start Help me set up the external service configuration by guiding me through the screens one step at a time.

Frequently Asked Questions about interactive-guide

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

FAQPage Schema
How do I guide a user through manual setup steps with an AI assistant?▼

Present an overall summary first with step count, prerequisites, and expected outcome, then guide one step at a time. Research current URLs and UI labels immediately before presenting each step, and confirm completion before advancing to the next.

When should an AI agent hand a task off to the user instead of automating it?▼

Hand off only when two gates pass: no CLI, official API, or MCP path exists for the operation, and the step genuinely requires the user's own permissions, body, or devices. Examples include 2FA entry, CAPTCHAs, and admin consoles with no API.

How do I verify a user completed a GUI configuration step correctly?▼

Request a screenshot only when an error would not surface naturally in later steps or when research could not confirm the screen's variations. Otherwise a simple verbal confirmation suffices. Never request screenshots of screens displaying secrets like API keys.

What should I do when UI instructions don't match the actual screen?▼

Treat the user's screenshot as ground truth, re-fetch the official documentation in the same turn, and present only the corrected next action with the difference noted. Do not restart the entire walkthrough or proceed with unresolved contradictions.

Can AI assistants handle API keys and tokens during guided setup?▼

Never write secret values like tokens or passwords in instructions, chat, or progress comments, since they persist in plain text. Refer to them indirectly, such as asking the user to paste the value they just issued, and avoid requesting screenshots of secret-displaying screens.