Ai Conversation Architect logo

Ai Conversation Architect

Community
varunk130
ai-conversation-architect

Design conversational AI interfaces that feel natural, recover from failures gracefully, and build user trust through dialogue. Use when: chatbot UX, conversational UI, dialogue design, AI assistant interface, chat flow, turn-taking, AI persona voice, multi-turn context.

Overview

Publishervarunk130
Repositoryai-ux-skill-library
Skill nameai-conversation-architect
Stars
3
Forks
0
Bundled files
Instructions only
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by varunk130 on GitHub. Read the source before you install it.

Installation

Install the Ai Conversation Architect AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/varunk130/ai-ux-skill-library/tree/main/skills/ai-conversation-architect
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/varunk130/ai-ux-skill-library.git /tmp/ai-ux-skill-library
mkdir -p .claude/skills
cp -r /tmp/ai-ux-skill-library/skills/ai-conversation-architect .claude/skills/ai-conversation-architect
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Ai Conversation Architect in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Ai Conversation Architect on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Ai Conversation Architect is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

AI Conversation Architect

Design conversations between humans and AI that are natural, purposeful, and resilient. The DIALOGUE framework ensures every conversational AI experience handles the full spectrum from first message to complex multi-turn reasoning.

Core Principle

A conversation with AI is not a command line with friendlier words. It is a collaborative sense-making process where both parties contribute, clarify, and course-correct. Design for the collaboration, not just the query.


The DIALOGUE Framework

LetterPhaseDesign Question
DDiscover IntentHow does the system understand what the user actually wants (not just what they typed)?
IIdentify AmbiguityWhere might the user's request be unclear, and how does the AI ask for clarification without interrogating?
AAdapt ToneHow does the AI match the user's emotional state, formality, and expertise level?
LLayer InformationHow is the response structured so users get the right depth - summary first, details on demand?
OOffer NavigationHow does the AI help users explore related topics, refine their question, or pivot direction?
GGuard BoundariesHow does the AI communicate what it can and cannot do without breaking conversational flow?
UUnderstand MemoryHow does the conversation maintain context across turns, sessions, and time?
EExit GracefullyHow does the conversation end - or hand off to a human - without abandoning the user?

Conversation Turn Anatomy

Every AI response has four invisible layers. Design all four explicitly:

LayerWhat It DoesExample
AcknowledgmentShows the AI understood the input"You're asking about deployment options for your EU customers."
SubstanceDelivers the actual answer or actionThe core content, recommendation, or task completion
OrientationTells the user where they are and what's possible next"Would you like me to compare the pricing for each option?"
MetacommunicationSignals about the conversation itself (confidence, limitations)"I'm fairly confident about this, but you should verify the regulatory details."

Anti-pattern: Most AI chat UIs only design the Substance layer. The result feels like talking to a search engine that happens to use sentences.


The Turn-Taking Contract

Unlike human conversation, AI has no body language, no pauses, no "hmm." You must design explicit turn-taking signals.

AI-to-Human Handoff Signals

Signal TypeWhen to UsePattern
Direct questionWhen you need specific input"Which region should I focus on - US, EU, or both?"
Suggestion menuWhen options are finite and clearPresent 2-4 clickable options + free text fallback
Soft promptWhen the conversation could go multiple directions"Let me know if you'd like to dig deeper into any of these."
Completion signalWhen the task is done"Done - your report is saved. Anything else?"
SilenceNeverAI should never leave the user hanging without a clear signal of what's expected

Human-to-AI Input Patterns

Design for how users actually type, not how you wish they would:

Real User BehaviorDesign Response
Single-word inputs ("pricing")Infer from context; don't demand full sentences
Multi-intent messages ("fix the bug and also update the docs")Parse and address both; confirm you caught everything
Corrections mid-thought ("wait, I meant the other one")Override previous context gracefully
Copy-pasted walls of textSummarize what you understood before responding
Emotional venting ("this is so frustrating")Acknowledge the emotion before problem-solving

Persona Voice Design

Every AI product needs a voice specification - not a marketing persona, but an interaction-level voice that governs word choice, sentence structure, and emotional register.

The Voice Compass (4 Axes)

Rate your AI voice on each axis (1-10):

AxisLow End (1)High End (10)Example LowExample High
FormalityCasual, conversationalProfessional, structured"Hey! Here's what I found""Based on my analysis, the following results are relevant"
AssertivenessHedging, tentativeConfident, direct"This might work, maybe?""Use this approach. Here's why."
WarmthNeutral, transactionalEmpathetic, relational"Error detected in row 3.""I found an issue in row 3 - here's how to fix it."
DensitySparse, minimalRich, detailed"3 results found.""I found 3 matching records, sorted by relevance. The top result..."

Rule: Document your compass coordinates (e.g., F:3 / A:7 / W:6 / D:5) and validate against 20+ real interaction scenarios before shipping.


Multi-Turn Context Design

The #1 complaint about AI assistants: "It forgot what I said 3 messages ago."

Context Retention Tiers

TierScopeWhat to RememberStorage
Turn contextCurrent messageEntities, intent, toneWorking memory
Session contextCurrent conversationTopic thread, decisions made, preferences statedSession state
Relationship contextAcross all conversationsUser preferences, past interactions, expertise levelPersistent profile
Shared contextAcross users (with consent)Organizational knowledge, team conventionsKnowledge base

Context Window Overflow Pattern

When the conversation exceeds the context window:

  1. Summarize, don't truncate - Compress earlier turns into a structured summary
  2. Preserve decisions - Any user choice or preference from earlier turns must survive compression
  3. Signal the compression - "I've summarized our earlier discussion to stay focused. Let me know if I missed anything important."
  4. Allow retrieval - Let users ask "What did we discuss about X?" and reconstruct from the summary

Conversation Failure Patterns

Failure ModeUser ExperienceDesign Solution
Intent misfireAI answers the wrong questionReflect understanding before answering: "Just to confirm, you're asking about..."
Context amnesiaAI forgets earlier turnsSummarize running context every 5-7 turns
Tone mismatchUser is frustrated, AI is cheerfulDetect sentiment signals; mirror appropriate register
Infinite loopAI keeps asking clarifying questionsAfter 2 clarifications, make a best-effort attempt and let the user correct
Dead endAI says "I can't help with that" with no alternativeAlways offer: (1) rephrase suggestion, (2) alternative topic, (3) human handoff
OversharingAI dumps 500 words when 50 would doLayer responses: headline → summary → details on demand

Anti-Patterns

PatternWhy It Fails
Starting every response with "Great question!"Feels patronizing by message 3. Acknowledge context, not the question itself
Using the user's name in every responseReads as scripted call center, not natural conversation
Apologizing excessively ("I'm sorry, I'm just an AI...")Erodes confidence. State limitations factually, without self-deprecation
Offering numbered lists for everythingNot every answer is a listicle. Match format to content type
Pretending to have emotions ("I'm excited to help!")Users detect inauthenticity. Be helpful without performing enthusiasm
Asking "Is there anything else?" after every responseCreates obligation. Let users initiate naturally

Quick Reference

TaskFramework ElementKey Deliverable
Design a new AI chat productFull DIALOGUE frameworkVoice Compass + Turn-Taking Contract + Context Tiers
Audit an existing chatbotFailure Patterns tableIssue log with severity and fix priority
Define AI personalityVoice Compass (4 Axes)Documented coordinates + 20 interaction examples
Fix "AI feels robotic" complaintsTurn Anatomy (4 Layers)Revised responses with all 4 layers explicit
Handle multi-turn breakdownsContext Retention TiersContext management architecture

Integration

Works with: ai-trust-transparency (confidence in conversation), ai-error-resilience (hallucination recovery mid-dialogue), ai-prompt-ux (how users initiate conversations), ai-feedback-loops (in-conversation feedback signals).

Frequently asked questions

What does the Ai Conversation Architect AI skill do?

Design conversational AI interfaces that feel natural, recover from failures gracefully, and build user trust through dialogue. Use when: chatbot UX, conversational UI, dialogue design, AI assistant interface, chat flow, turn-taking, AI persona voice, multi-turn context.

Why use Ai Conversation Architect on TypingMind?

Because you install it once and use it with any model. Ai Conversation Architect is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Ai Conversation Architect in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/varunk130/ai-ux-skill-library/tree/main/skills/ai-conversation-architect. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Ai Conversation Architect?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Ai Conversation Architect?

As many as you like. As long as a model supports skills, you can use Ai Conversation Architect with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Ai Conversation Architect AI skill free?

Yes. It is published on GitHub by varunk130 under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇