Agent skill

Chatbot Conversation Design

by seb1n in seb1n/awesome-ai-agent-skills

Design structured, engaging chatbot conversations with robust intent handling, slot filling, disambiguation, error recovery, and graceful fallback strategies.

MITAuto-check passedSales & Support

Install Chatbot Conversation Design

skills CLI
$ npx skills add seb1n/awesome-ai-agent-skills --skill chatbot-conversation-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install seb1n/awesome-ai-agent-skills chatbot-conversation-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/seb1n/awesome-ai-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/communication/chatbot-conversation-design .claude/skills/chatbot-conversation-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
chatbot-conversation-design
GitHub stars
206
Token cost
~2.3k tokens
SKILL.md length
909 words
Files
1
Skills in repo
101
Repo updated
First seen
Licence
MIT

At a glance

Design structured, engaging chatbot conversations with robust intent handling, slot filling, disambiguation, error recovery, and graceful fallback strategies.

  • Works in 6 steps: Define the bot persona and scope.… → Map intents, entities, and user… → Design slot-filling and disambiguation… → …
  • The user requests chatbot conversation design
  • SKILL.md covers Workflow, Usage, Examples and Best Practices, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Chatbot Conversation Design is an agent skill from seb1n/awesome-ai-agent-skills. Design structured, engaging chatbot conversations with robust intent handling, slot filling, disambiguation, error recovery, and graceful fallback strategies. Use when the user requests chatbot conversation design or provides relevant inputs for this workflow.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Sales & Support. The repository describes itself as: 103 ready-to-use AI agent skills for Claude Code, OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot, Windsurf, and other Agent Skills-compatible tools. Complete SKILL.md… The licence is MIT.

When your agent uses it

  • The user requests chatbot conversation design
  • Provides relevant inputs for this workflow

Example prompts

  • “/chatbot-conversation-design”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Define the bot persona and scope. Establish the chatbot's personality traits (friendly, professional, concise, witty) and guardrails…
  2. Map intents, entities, and user journeys. Identify every intent the bot must handle — both primary task intents (e.g., order.place…
  3. Design slot-filling and disambiguation dialogs. For each intent, define the slot-filling sequence — which entities are required, which are…
  4. Build error recovery and fallback flows. Design three tiers of fallback: (1) rephrasing the question when confidence is low, (2) offering…
  5. Implement context carryover and state management. Define how dialog state persists across turns. Specify which slots carry forward (e.g…
  6. Prototype, test, and iterate. Build a low-fidelity prototype using conversation scripts or tools like Botmock, Voiceflow, or Dialogflow…

What it can do on your machine

Read from SKILL.md and the folder at commit 75865a5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Chatbot Conversation Design loads about 2.3k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 909 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from seb1n/awesome-ai-agent-skills at commit 75865a5, republished under its MIT licence (© seb1n). 909 words, ~2,331 tokens.

Download SKILL.mdSave it as .claude/skills/chatbot-conversation-design/SKILL.md (or your agent's skills folder).
name
chatbot-conversation-design
description
Design structured, engaging chatbot conversations with robust intent handling, slot filling, disambiguation, error recovery, and graceful fallback strategies. Use when the user requests chatbot conversation design or provides relevant inputs for this workflow.
license
MIT
metadata.author
awesome-ai-agent-skills
metadata.version
1.0.0

Chatbot Conversation Design

This skill provides a comprehensive framework for designing chatbot conversations that feel natural, handle ambiguity gracefully, and guide users toward successful outcomes. It covers the full design lifecycle — from persona definition and intent mapping through dialog state management, error recovery, and iterative testing. The focus is on building conversations that are resilient to unexpected inputs while maintaining a consistent, helpful tone.

Workflow

  1. Define the bot persona and scope. Establish the chatbot's personality traits (friendly, professional, concise, witty) and guardrails. Define what the bot can and cannot do. A well-scoped bot that excels at five tasks outperforms a vague bot that attempts fifty. Document the persona in a style guide that includes vocabulary preferences, emoji usage rules, response length targets, and escalation triggers.

  2. Map intents, entities, and user journeys. Identify every intent the bot must handle — both primary task intents (e.g., order.place, account.reset_password) and meta-intents (e.g., help, cancel, speak_to_human). For each intent, list the required entities (slots) the bot must collect. Map the conversation flows as directed graphs showing happy paths, branching points, and exit conditions. Ensure every path terminates in either a resolution or a graceful handoff.

  3. Design slot-filling and disambiguation dialogs. For each intent, define the slot-filling sequence — which entities are required, which are optional, and in what order the bot should prompt for them. When user input is ambiguous (e.g., "the large one" when multiple products qualify), design disambiguation prompts that present clear options without overwhelming the user. Use confirmation prompts for high-stakes actions like payments or cancellations.

  4. Build error recovery and fallback flows. Design three tiers of fallback: (1) rephrasing the question when confidence is low, (2) offering a constrained set of options when the intent is unclear after two attempts, and (3) escalating to a human agent when the bot cannot recover. Never let the conversation hit a dead end. Every error state should include a recovery path and a way to restart or exit gracefully.

  5. Implement context carryover and state management. Define how dialog state persists across turns. Specify which slots carry forward (e.g., the user's name should persist for the session) and which reset between tasks. Design the context stack so the bot can handle mid-conversation topic switches ("Actually, before that, can you check my balance?") and return to the original flow afterward.

  6. Prototype, test, and iterate. Build a low-fidelity prototype using conversation scripts or tools like Botmock, Voiceflow, or Dialogflow CX. Test with real users to identify where conversations break down. Track metrics: task completion rate, average turns to resolution, fallback trigger rate, and escalation rate. Iterate on the weakest flows first.

Usage

This skill is for developers, UX writers, and product managers designing conversational interfaces. Provide the agent with the bot's purpose, target user base, and the list of tasks it should handle.

  • For new chatbots: Follow the workflow end-to-end to build a complete conversational architecture.
  • For existing chatbots: Use this skill to audit conversation flows, identify dead ends, and improve error handling.

Prompt format:

Design a chatbot conversation for [use case].
Bot persona: [personality traits]
Supported tasks: [list of tasks]
Platform: [web widget / Slack / WhatsApp / voice assistant]

Examples

Example 1: Customer Support Bot — Complete Conversation Flow

Design specification:

json
{
  "bot_name": "HelpBot",
  "persona": "Friendly, efficient, empathetic",
  "intent": "order.track",
  "required_entities": [
    { "name": "order_id", "type": "string", "prompt": "What's your order number?" },
    { "name": "email", "type": "email", "prompt": "What email did you use for the order?" }
  ],
  "optional_entities": [
    { "name": "issue_type", "type": "enum", "values": ["delayed", "damaged", "wrong_item", "other"] }
  ]
}

Conversation flow:

User: Where's my order?

HelpBot: I'd be happy to look that up for you! Could you share your order number?
         It usually starts with "ORD-" and is in your confirmation email.

User: ORD-29481

HelpBot: Got it. And what email address did you place the order with?

User: marcus@email.com

HelpBot: Thanks, Marcus. I found your order — here's the latest status:

         Order: ORD-29481
         Status: In transit
         Carrier: FedEx
         Tracking: 7749 2381 0042
         Estimated delivery: Thursday, March 6

         Is there anything else about this order I can help with?

User: It was supposed to arrive yesterday.

HelpBot: I'm sorry about the delay. It looks like there was a weather-related
         shipping disruption. Based on the latest tracking update, it should
         arrive by end of day Thursday.

         Would you like me to:
         1. Send you tracking updates via email
         2. Connect you with our shipping team
         3. Something else

User: Option 1 please.

HelpBot: Done! You'll receive email updates at marcus@email.com whenever the
         tracking status changes. Is there anything else I can help with?
Example 2: Error Handling and Fallback Flow

Scenario: The bot receives an input it cannot classify.

User: asdfghjkl

HelpBot: I didn't quite catch that. Could you rephrase what you're looking for?
         I can help with things like:
         - Tracking an order
         - Returns and refunds
         - Account questions

User: I want to do the thing with the stuff

HelpBot: I want to make sure I help you with the right thing. Which of these
         is closest to what you need?
         1. Track an existing order
         2. Start a return or refund
         3. Update your account info
         4. Something else

User: 4

HelpBot: No problem — let me connect you with a team member who can help.
         You'll be transferred to a live agent shortly. Your reference
         number is #SUP-8842 so you won't have to repeat anything.

         [Escalating to human agent...]

State management notes: After two failed classification attempts (confidence < 0.3), the bot transitions from open-ended prompts to a constrained option list. After a third failure or explicit "something else" selection, it escalates with full context attached to the handoff payload.

Show full SKILL.md (338 more words)Show less

Best Practices

  • Design for the unhappy path first. Most conversations will deviate from the ideal flow. Invest more time in error recovery and edge cases than in the happy path, which is straightforward to build.
  • Keep bot utterances under 3 sentences. Long bot responses cause users to skim or disengage. Break complex information into multiple turns or use structured formats (lists, cards).
  • Confirm before executing irreversible actions. Always add a confirmation step before actions like cancellations, payments, or data deletion. Show the user exactly what will happen.
  • Use progressive disclosure. Don't dump all options upfront. Start with the most common paths and offer "more options" only when needed.
  • Carry context across turns naturally. If a user says "I'd like a large," the bot should remember they were discussing pizza from the previous turn. Explicit confirmation ("A large pizza, right?") is better than asking them to repeat.
  • Provide escape hatches at every step. Users should always be able to say "cancel," "start over," or "talk to a human" and get an immediate, helpful response.

Edge Cases

  • Multi-intent inputs. When a user says "Track my order and also start a return," the bot should acknowledge both intents and handle them sequentially, confirming when it transitions from one task to the next.
  • Mid-flow topic switching. If a user changes topics mid-conversation, push the current dialog state onto a stack and handle the new intent. Offer to return to the previous task when the interruption resolves.
  • Contradictory information. When a user provides conflicting details (e.g., different email addresses in the same session), flag the inconsistency and ask for clarification rather than silently using the latest value.
  • Sensitive or emotional content. If the user expresses frustration, anger, or distress, the bot should acknowledge the emotion ("I understand this is frustrating") before proceeding with the solution. Never respond with generic cheerfulness to a clearly upset user.
  • Platform-specific constraints. WhatsApp limits message length and button options differently than a web widget. Design conversations that adapt to the platform's capabilities rather than forcing a one-size-fits-all flow.

© seb1n, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in communication/chatbot-conversation-design of seb1n/awesome-ai-agent-skills.

Open the folder on GitHubat commit 75865a5

Compare with similar skills

Chatbot Conversation Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Chatbot Conversation Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Chatbot Conversation Design this skillseb1n/awesome-ai-agent-skills206—~2.3kAutomated safety check: PassMIT
Cold Outbound Optimizerericosiu/ai-marketing-skills3.6k1 repos~1.7kAutomated safety check: PassMIT
Doc Coauthoringaws-samples/sample-strands-agent-with-agentcore19541 repos~3.2kAutomated safety check: PassMIT
Amazon Buy Box Monitorbrowser-act/skills6.1k1 repos~1.6kAutomated safety check: PassMIT
Review Analysisliangdabiao/amazon-sorftime-research-MCP-skill9531 repos~2.5kAutomated safety check: PassNone
Deskcomm Extensaomelgarafael/DeskcommCRM4.5k—~2.7kAutomated safety check: PassMIT

Similar skills

  • Cold Outbound Optimizer

    ericosiu/ai-marketing-skills

    Design, analyze, and optimize cold outbound email campaigns for Instantly.

    3.6k GitHub starsUsed in 1 repo~1.7k tokens
    Sales & SupportAuto-check passed
  • Doc Coauthoring

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Guide users through a structured workflow for co-authoring documentation.

    195 GitHub starsUsed in 41 repos~3.2k tokens
    Sales & SupportAuto-check passed
  • Amazon Buy Box Monitor

    browser-act/skills

    Pulls Amazon product details, competing seller prices and seller ratings for a given ASIN through the BrowserAct API, without browser automation.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Sales & SupportAuto-check passed
  • Review Analysis

    liangdabiao/amazon-sorftime-research-MCP-skill

    对亚马逊商品评论进行深度分析,自动识别产品痛点、分析退货原因,生成改进建议和客服回复模板。Invoke when user uses /review-analysis command with a product ASIN.

    953 GitHub starsUsed in 1 repo~2.5k tokens
    Sales & SupportAuto-check passed
  • Deskcomm Extensao

    melgarafael/DeskcommCRM

    Guia para criar uma extensão do DeskcommCRM — o pacote declarativo — em vez de abrir um PR no núcleo.

    4.5k GitHub stars~2.7k tokensUpdated today
    Sales & SupportAuto-check passed
  • Tourmind Booking

    tourmind-com/Tourmind-Booking-Skills

    MUST USE for any hotel or accommodation intent in any language, including hotel search, hotel recommendations, nearby accommodation, hostels, guesthouses, resorts, where-to-stay questions, room…

    1.7k GitHub stars~13k tokensUpdated yesterday
    Sales & SupportAuto-check passed

More from seb1n/awesome-ai-agent-skills

All 101 skills in this repo
  • Agent Red Teaming

    seb1n/awesome-ai-agent-skills

    Plan, execute, document, and retest authorized security assessments of AI agents and multi-agent workflows using safe adversarial cases, synthetic identities, canaries, and evidence-based findings.

    206 GitHub stars~2.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Eu AI Act Readiness

    seb1n/awesome-ai-agent-skills

    Build a preliminary, evidence-based EU AI Act readiness assessment across AI-system inventory, territorial scope, operator roles, prohibited-practice screening, risk classification, transparency…

    206 GitHub stars~3.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Human In The Loop

    seb1n/awesome-ai-agent-skills

    Design and verify auditable human oversight, approval gates, escalation paths, and safe state transitions for AI agent workflows.

    206 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • MCP Server Building

    seb1n/awesome-ai-agent-skills

    Design, implement, harden, and verify Model Context Protocol (MCP) servers with precise tool contracts, least-privilege authorization, safe transports, structured errors, and interoperability tests.

    206 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • PDF Processing

    seb1n/awesome-ai-agent-skills

    Inspect, extract, OCR, create, merge, split, reorder, rotate, annotate, fill, redact, compress, secure, and verify PDF documents while preserving source files and visual fidelity.

    206 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Skill Supply Chain Audit

    seb1n/awesome-ai-agent-skills

    Audit agent skills, plugins, prompts, manifests, scripts, dependencies, and bundled assets for provenance, prompt-injection, permission, execution, exfiltration, persistence, and update risk.

    206 GitHub stars~2.4k tokensUpdated 2 mo ago
    Auto-check passed

Categories

Questions about Chatbot Conversation Design

What does Chatbot Conversation Design do?

Design structured, engaging chatbot conversations with robust intent handling, slot filling, disambiguation, error recovery, and graceful fallback strategies. Chatbot Conversation Design is an agent skill from seb1n/awesome-ai-agent-skills. Design structured, engaging chatbot conversations with robust intent handling, slot filling, disambiguation, error recovery, and graceful fallback strategies.

When should I use Chatbot Conversation Design?

Chatbot Conversation Design fits situations like: the user requests chatbot conversation design; provides relevant inputs for this workflow.

How do I install Chatbot Conversation Design in Claude Code?

Run `npx skills add seb1n/awesome-ai-agent-skills --skill chatbot-conversation-design -a claude-code`. Or copy the skill folder (communication/chatbot-conversation-design in seb1n/awesome-ai-agent-skills) into .claude/skills/chatbot-conversation-design in your project. Claude Code loads it when a task matches its description.

How do I install Chatbot Conversation Design in Codex?

Run `npx skills add seb1n/awesome-ai-agent-skills --skill chatbot-conversation-design -a codex`. Or copy the skill folder (communication/chatbot-conversation-design in seb1n/awesome-ai-agent-skills) into .agents/skills/chatbot-conversation-design in your project. Codex loads it when a task matches its description.

Can I use Chatbot Conversation Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add seb1n/awesome-ai-agent-skills --skill chatbot-conversation-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/chatbot-conversation-design, .gemini/skills/chatbot-conversation-design, .github/skills/chatbot-conversation-design and .opencode/skills/chatbot-conversation-design in your project.

What does Chatbot Conversation Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Chatbot Conversation Design is instructions for the agent only.

Does Chatbot Conversation Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Chatbot Conversation Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Chatbot Conversation Design use?

Chatbot Conversation Design is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Chatbot Conversation Design use?

About 2.3k tokens (SKILL.md is roughly 9.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Chatbot Conversation Design?

Skills that share tags, products or a category with Chatbot Conversation Design: Cold Outbound Optimizer (ericosiu/ai-marketing-skills, 3.6k stars), Doc Coauthoring (aws-samples/sample-strands-agent-with-agentcore, 195 stars), Amazon Buy Box Monitor (browser-act/skills, 6.1k stars) and Review Analysis (liangdabiao/amazon-sorftime-research-MCP-skill, 953 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Chatbot Conversation Design?

seb1n (a GitHub user) maintains it in seb1n/awesome-ai-agent-skills, which has 206 GitHub stars. The repository holds 101 skills in this directory. The repository was last updated on August 9, 2026.

Source: seb1n/awesome-ai-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.