← Back to Skills Marketplace
szpili

Guided Conversation

by Szpili · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
180
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install guided-conversation
Description
Minimize user friction by asking up to 4 clarifying questions before executing actions.
README (SKILL.md)

Guided Conversation Skill

Purpose

Minimize user friction by asking up to 4 clarifying questions before executing actions. Ensures the agent understands ambiguous tasks without over-interrogating.

When to Use

  • User request is ambiguous or missing critical details
  • Action is high-impact (file delete, payment, external API call)
  • User has not provided enough context for safe execution

Constraints

  • Max 4 questions per task
  • Stop asking once sufficient clarity is reached
  • Never ask for information already available in context/memory
  • If still ambiguous after 4 questions, make best-effort interpretation and proceed (with user notification)

Output

After clarification:

  1. Summarize understood task in 1 sentence
  2. List assumptions made
  3. Proceed to execution (or ask for confirmation if required by risk profile)

Integration

  • Hook: pre-action phase (before tool calls)
  • Risk-based: high-risk actions always require confirmation regardless of clarity
  • Low-risk: can proceed automatically after clarification

Examples

User: "Zrób backup" Agent: "Which folder? Where to store? Full or incremental?" (3 questions)

User: "Wyślij maila do klienta" Agent: "Who is the client? What content? Any attachments?" (3 questions)

Configuration

  • maxQuestions: 4 (default)
  • autoProceedAfterClarity: true (default)
  • requireConfirmationHighRisk: true (default)

Related Skills

  • interaction-pipeline (status updates)
  • adaptive-execution-profile (risk tolerance)
Usage Guidance
This skill is coherent and low-risk because it only provides conversational instructions and asks for no secrets or installs. Before enabling: (1) enable requireConfirmationHighRisk (or set autoProceedAfterClarity=false) so high-impact actions always require explicit user consent; (2) consider lowering auto-proceed behavior or increasing maxQuestions if you prefer safety over convenience; (3) test the skill in a safe environment to ensure its 'best-effort' behavior doesn't perform unwanted actions; (4) verify it does not prompt for or transmit sensitive info (passwords, keys) and that it respects existing context/memory as promised; (5) review how it interacts with other skills (e.g., tools that perform external actions) to ensure confirmations are honored.
Capability Analysis
Type: OpenClaw Skill Name: guided-conversation Version: 1.0.0 The guided-conversation skill bundle provides purely instructional logic for an AI agent to clarify ambiguous user requests before execution. It includes safety-oriented constraints such as a maximum question limit and mandatory confirmation for high-risk actions, with no evidence of malicious code, data exfiltration, or harmful prompt injection in SKILL.md or _meta.json.
Capability Assessment
Purpose & Capability
Name/description (guided clarification) match the SKILL.md: no extra binaries, env vars, or installs are requested and nothing outside conversational guidance is required.
Instruction Scope
Instructions are limited to pre-action clarification and summarization, which is in-scope. Note: the policy 'if still ambiguous after 4 questions, make best-effort interpretation and proceed' increases risk of unintended actions; this is a design choice (usability vs safety) rather than an incoherence. Recommend enforcing requireConfirmationHighRisk and explicit safeguards for destructive or external-facing operations.
Install Mechanism
No install spec and no code files — lowest-risk form (instruction-only). Nothing will be written to disk or downloaded by the skill itself.
Credentials
The skill requests no environment variables, credentials, or config paths. Declared configuration options (maxQuestions, autoProceedAfterClarity, requireConfirmationHighRisk) are appropriate and proportional to the purpose.
Persistence & Privilege
always:false (default) and no persistent modifications or system-wide config changes are requested. Autonomous invocation is allowed by platform default but is not unusually privileged for this skill.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install guided-conversation
  3. After installation, invoke the skill by name or use /guided-conversation
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the guided-conversation skill. - Automatically asks up to 4 clarifying questions to resolve ambiguous user requests. - Summarizes the understood task and lists assumptions before executing actions. - Integrates with risk assessment: always requires confirmation for high-risk actions; proceeds automatically for low-risk tasks after clarification. - Configurable parameters: max questions, auto-proceed after clarity, and mandatory confirmation for high-risk actions.
Metadata
Slug guided-conversation
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Guided Conversation?

Minimize user friction by asking up to 4 clarifying questions before executing actions. It is an AI Agent Skill for Claude Code / OpenClaw, with 180 downloads so far.

How do I install Guided Conversation?

Run "/install guided-conversation" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Guided Conversation free?

Yes, Guided Conversation is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Guided Conversation support?

Guided Conversation is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Guided Conversation?

It is built and maintained by Szpili (@szpili); the current version is v1.0.0.

💬 Comments