agentsclimarketplace

Ai conversation architect

Skill varunk130/ai-ux-skill-library/skills/ai-conversation-architect

The 12-skill AI UX design engine for Claude Code & GitHub Copilot — purpose-built for designing UX for AI products, agents, and experiences.

Install
npx -y skills add varunk130/ai-ux-skill-library --skill ai-conversation-architect

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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.

SKILL.md

8.7 KB, as published. Nobody here has run it

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).

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.