SkillAgentSearch skills...

chatbot-flow-design

Designing conversational flows for website chatbots and AI agents. Intent recognition architecture, branching logic, fallback handling, escalation to human, conversation analytics.

Install / Use

npx skills add rampstackco/claude-skills --skill chatbot-flow-design

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

86/100

Supported Platforms

Universal

Our assessment of chatbot-flow-design

chatbot-flow-design scores 86/100 on our quality scale, 563rd of 947 AI & Machine Learning skills we index.

Its SKILL.md is 20 KB long, well organised into 14 sections and no code examples: a thorough specification that gives an agent plenty to work with.

It has 902 GitHub stars, a meaningful sign that others use it.

Substance
30/30
Structure
13/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so chatbot-flow-design is actively maintained.
  • Our last check on 2026-11-03 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

chatbot-flow-design compared with similar skills

All 4 of these similar skills score higher than chatbot-flow-design; compare them before choosing.

SkillScoreStarsUpdatedFormat
chatbot-flow-design (this skill)by rampstackco869022mo agoSKILL.md
claude-memby thedotmack100117.6ktodayCLAUDE.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Understand-Anythingby Egonex-AI10092.8k1d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md

Frequently asked questions

How do I install chatbot-flow-design?
Run npx skills add rampstackco/claude-skills --skill chatbot-flow-design. The install tabs above show the steps for each supported agent.
Which AI agents does chatbot-flow-design work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is chatbot-flow-design safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is chatbot-flow-design still maintained?
The repository was last updated about 2 months ago, so chatbot-flow-design is actively maintained.

name: chatbot-flow-design description: "Designing conversational flows for website chatbots and AI agents. Intent recognition architecture, branching logic, fallback handling, escalation to human, conversation analytics. Honest about scripted-bot (rigid trees, fail edge cases), hallucinating-bot (LLM without structure, makes things up), and structured-guided-conversation (LLM-powered with intent architecture and fallback discipline) patterns. Distinguishes chatbot DESIGN (this skill) from chatbot IMPLEMENTATION (engineering and platform work). Triggers on chatbot, conversational AI, AI agent, chat widget, intent design, conversational flow, bot escalation, LLM grounding. Also triggers when a chatbot is hallucinating, when a scripted bot is failing edge cases, or when a chatbot is being scoped for the first time." category: growth-tooling catalog_summary: "Designing conversational flows for chatbots and AI agents on websites. Distinguishes scripted-bot (rigid trees, fail edge cases) from hallucinating-bot (LLM without structure, makes things up) from structured-guided-conversation (LLM-powered with intent architecture and fallback discipline)" display_order: 5

Chatbot Flow Design

A senior growth practitioner's playbook for designing conversational flows for website chatbots and AI agents. Intent recognition architecture, branching logic, fallback handling, escalation to human, conversation analytics. The discipline of building a bot that knows what it knows and routes appropriately when it does not.

Most chatbots on the web fail in one of two ways. Scripted bots break the moment a user phrases something the script did not anticipate; the user gets pushed through a decision tree that does not fit their situation. LLM-powered bots without structure hallucinate; they confidently answer questions about pricing, policy, or capabilities and frequently make up answers, creating support burden and trust damage.

The chatbots that work do something different. They have an intent architecture that defines what the bot can and cannot handle. They ground their responses in a knowledge base so they do not invent facts. They have explicit fallback paths for unclear or out-of-scope intents. They escalate to humans cleanly when the bot's job is done. The audience trusts the bot because the bot is honest about its scope.

The voice is the senior growth practitioner who has watched chatbots become trusted brand surfaces and watched them become liability risks. Practical, opinionated about the architecture that distinguishes the two outcomes, willing to call out when a chatbot is the wrong investment or when an existing chatbot needs to be redesigned rather than tuned.

When to use this skill: scoping a chatbot for the first time, auditing a chatbot that hallucinates or fails edge cases, designing the intent architecture and fallback patterns, or deciding when to escalate to humans.


What this skill covers

This skill spans chatbot design as conversational flow architecture, not chatbot implementation. The growth-tooling distinctions:

  • ai-content-collaboration covers AI in content workflows. This skill covers AI in customer-facing conversations.
  • integration-orchestrator covers cross-team coordination for chatbot deployment. This skill is the conversational design itself.
  • pm-spec-writing covers the spec for engineers building the bot. This skill is about WHAT the conversation should be; pm-spec-writing is about communicating it.
  • discovery-research-synthesis covers customer research that informs intent architecture. Input to this skill, not part of it.
  • chatbot-flow-design (this skill) is intent architecture, knowledge-base grounding, fallback patterns, and escalation discipline.

The audience: growth marketers and product marketers shipping chatbot growth tooling, in-house teams designing conversational flows for marketing or support contexts, agencies running chatbot work for clients.

Out of scope: AI in content workflows (covered by ai-content-collaboration); the engineering implementation of chatbots (handed off via pm-spec-writing); platform-specific bot configurations (those stay implementation-side); voice agents and IVR flows (different methodology though related principles apply).


The chatbot decision: when chatbots earn deployment

Before designing the chatbot, decide whether a chatbot is the right tool.

Chatbots earn deployment when:

  • The audience asks the same questions repeatedly. FAQ-style support, product capability questions, qualification routing. The bot handles the volume; humans handle the exceptions.
  • The audience is on the site at hours when humans cannot respond. Coverage gap that the bot fills meaningfully.
  • The bot can ground its answers in real knowledge (documentation, product specs, pricing pages). Without grounding, the bot's answers are at best generic and at worst fabricated.
  • The team can maintain the bot. Chatbots decay; intents drift; knowledge bases need updating. Without maintenance commitment, the bot becomes stale liability.

Chatbots do NOT earn deployment when:

  • The audience expects human conversation. Sales conversations, complex troubleshooting, sensitive topics often warrant human-first.
  • The team cannot ground the bot in real knowledge. A bot without grounding either hallucinates or stays so generic it adds no value.
  • The bot would replace working human channels. Replacing a high-quality sales chat with a low-quality bot degrades the experience.
  • The audience is small enough that direct human conversation is more efficient.
  • The team cannot maintain the bot. Stale bots produce wrong answers.

The decision is not "should we have a chatbot"; it is "is the chatbot the right tool for this specific audience and conversation."

Detail in references/chatbot-decision-criteria.md.


Scripted-bot vs hallucinating-bot vs structured-guided-conversation

The keystone framing.

Scripted-bot. Rigid decision tree. "Press 1 for X, 2 for Y." Fails the moment a user phrases something the script did not anticipate. The chatbot equivalent of an automated phone tree. Cost: the user's actual question goes unanswered; the bot pushes the user through paths that do not fit; the audience leaves with a worse experience than no bot.

Hallucinating-bot. LLM-powered with no structure. Will confidently answer questions about pricing, policy, capabilities, and frequently make up answers. Liability risk; trust-eroding; support burden when wrong answers reach customers. Cost: the bot's confident wrong answers damage the brand more than no bot would; the team learns about the hallucinations through customer complaints.

Structured-guided-conversation. LLM-powered with intent architecture, knowledge-base grounding, defined fallback paths, and explicit escalation to humans. The bot knows what it knows, knows what it does not, and routes appropriately. Cost: the design effort upfront is significant; the maintenance is real; the audience trusts the bot because the bot is honest about its scope.

The litmus test. Ask the bot a question outside its intended scope. Does it confidently make up an answer (hallucinating), refuse rigidly (scripted), or honestly route the user to a human or alternative resource (structured-guided)? The third response is the goal.


Intent architecture

Defining what the bot can and cannot handle.

The principle. The bot has a defined set of intents it can handle. Each intent maps to a conversation pattern (questions to ask, knowledge to ground in, response to provide). Anything outside the intent set falls to fallback.

Intent design patterns.

  • Named intents. "Pricing question," "feature comparison," "integration question," "support escalation," "demo request." Each intent is explicit.
  • Intent hierarchy. Top-level categories with sub-intents. "Pricing question" includes sub-intents for "tier comparison," "discount inquiry," "billing question."
  • Intent boundaries. Each intent has clear scope. Out-of-scope topics route to fallback.

Intent coverage. The bot's intents should cover 70-90 percent of expected conversations. The remaining percentage falls to fallback. Trying to cover 100 percent often produces bloated intent sets that the bot cannot handle reliably.

Intent maintenance. Intents drift as products evolve, audiences shift, and conversations change. Periodic review surfaces which intents are useful and which need refining.

Detail in references/intent-architecture-patterns.md.


Knowledge-base grounding

The bot's responses must come from real knowledge, not made-up confidence.

The principle. The bot's response generation should reference a structured knowledge base (documentation, product specs, pricing pages, support articles). The bot does not invent answers; it retrieves and presents.

Grounding patterns.

  • Retrieval-augmented generation (RAG). The bot searches a knowledge base for relevant content before generating a response. The response is grounded in retrieved content.
  • Source-of-truth design. The knowledge base is the canonical source. When the bot answers, the underlying source is identified.
  • Citation discipline. The bot can cite the source ("based on our pricing page, ..."). Audiences benefit from knowing where the answer came from.
  • Knowledge-base maintenance. The knowledge base is maintained as the product evolves; the bot's answers stay current.

The hallucinating-bot failure. No grounding. The LLM generates confident-sounding answers from nothing. The team discovers wrong answers through customer complaints.

The structured-guided win. Grounded answers. The bot's responses match the source-of-truth. Customer-facing accuracy is maintained.

Detail in references/knowledge-base-grounding-patterns.md.


Branching and conditional logic

How the bot adapts the conversation based on user input.

The principle. The bot's conversation can branch based on user inputs (intent recognized, prior answers, user attributes). Branching makes the conversation feel adaptive.

Branching patterns.

  • Intent-driven branching. Different intents lead to different conversation flows.
  • Context-driven branching. "Are you asking about plan A or plan B?" routes to plan-specific information.
  • User-attribute branching. Logged-in users may see different responses than anonymous users; enterprise visitors may see different responses than SMB.
  • Multi-turn branching. The conversation deepens over turns; later turns build on earlier context.

Branching discipline. Each branch should add value. Decorative branching (asking for confirmation when none is needed) adds friction.

Branching limits. Bots that branch too deeply lose users. 3-5 turns is often the practical limit before the user wants resolution.

Detail in references/branching-and-conditional-logic.md.


Fallback patterns

What happens when intent is unclear or out-of-scope.

The principle. Every conversation has fallback paths. The bot has rehearsed responses for "I do not know," "I am not sure I can help with that," "Let me connect you with a human."

Fallback patterns.

  • Clarifying question. "Can you tell me more about what you are looking for?" Asks the user to refine; sometimes recovers.
  • Suggested intents. "I can help with X, Y, or Z. Were you asking about one of those?" Surfaces what the bot can do.
  • Resource handoff. "I cannot answer that, but here is our [documentation page] that covers it."
  • Human escalation. "Let me connect you with a human who can help."

Fallback discipline. Multiple fallback layers. First, try clarification. If unclear after one round, s

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars902
CategoryAI
Updated2mo ago
Forks124

Languages

JavaScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions