Skip to content

varunk130/ai-ux-skill-library

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 

Repository files navigation

AI UX Skill Library

The 11-Skill AI UX Design Engine for Claude Code & GitHub Copilot

Skills Frameworks License

Created and maintained by Varun Kulkarni

Purpose-built skills for designing UX for AI products, AI agents, and AI-powered experiences. Each skill encodes a proprietary framework for the unique UX challenges that only exist when humans interact with AI — trust calibration, hallucination recovery, agentic control, prompt interfaces, and more.


Why This Exists

Traditional UX skills don't cover AI. When your product can hallucinate, act autonomously, and produce different outputs from the same input — you need a new UX design vocabulary. This library provides it.

General UX skills (journey mapping, accessibility, design systems) are well-served by existing resources. This library focuses exclusively on the delta — the 11 UX challenges that are unique to AI products and don't exist in traditional software or digital products.


Ecosystem Architecture

The skills are organized into 3 design phases for AI products:

┌─────────────────────────────────────────────────────────────────────┐
│                    AI UX SKILLS ECOSYSTEM                           │
│                                                                     │
│   ┌────────────────────────────────────────────────────┐           │
│   │  🎯 FOUNDATION (How users start with AI)           │           │
│   │                                                    │           │
│   │  ai-onboarding-calibration  ·  ai-prompt-ux       │           │
│   │  ai-journey-mapper                                 │           │
│   └──────────────────────┬─────────────────────────────┘           │
│                          │                                         │
│                          ▼                                         │
│   ┌────────────────────────────────────────────────────┐           │
│   │  🤖 INTERACTION (How users work with AI)           │           │
│   │                                                    │           │
│   │  ai-conversation-architect  ·  ai-agent-ux        │           │
│   │  ai-feedback-loops  ·  ai-multimodal-output       │           │
│   └──────────────────────┬─────────────────────────────┘           │
│                          │                                         │
│                          ▼                                         │
│   ┌────────────────────────────────────────────────────┐           │
│   │  🛡️ TRUST & SAFETY (How users trust AI)            │           │
│   │                                                    │           │
│   │  ai-trust-transparency  ·  ai-error-resilience    │           │
│   │  ai-safety-guardrails  ·  ai-personalization-ethics│           │
│   └────────────────────────────────────────────────────┘           │
└─────────────────────────────────────────────────────────────────────┘

Skills Catalog

# Skill Framework Phase What It Solves
1 AI Conversation Architect DIALOGUE Interaction Conversational AI interfaces — turn-taking, persona voice, multi-turn context, error recovery
2 AI Trust & Transparency GLASS Trust & Safety Explainability UX — confidence indicators, citation design, source attribution
3 AI Error Resilience RECOVER Trust & Safety Hallucinations, uncertainty, graceful degradation, safe fallbacks
4 AI Agent UX AUTONOMY Interaction Agentic AI — autonomy controls, consent, action previews, undo/rollback, audit trails
5 AI Onboarding & Calibration CALIBRATE Foundation Progressive disclosure, mental model calibration, expectation setting
6 AI Feedback Loops SIGNAL Interaction RLHF UX — thumbs up/down, preference ranking, human-in-the-loop
7 AI Prompt UX CRAFT Foundation Prompt interface design — input affordances, templates, suggestions
8 AI Personalization & Ethics ADAPT Trust & Safety Adaptive interfaces, privacy balance, filter bubble prevention
9 AI Safety Guardrails SHIELD Trust & Safety Content moderation UX, bias detection, harm prevention, refusal design
10 AI Journey Mapper PATHWAY Foundation AI-specific journey mapping — trust arcs, capability discovery, autonomy transitions
Bonus AI Output & Multimodal Design RENDER Interaction Response formatting, output hierarchy, cross-modal presentation

Framework Quick Reference

Framework Mnemonic Core Concept
DIALOGUE _D_iscover, _I_dentify, _A_dapt, _L_ayer, _O_ffer, _G_uard, _U_nderstand, _E_xit Design conversations, not command lines
GLASS _G_round, _L_ayer, _A_dvertise, _S_how, _S_upport Make AI reasoning visible
RECOVER _R_ecognize, _E_xpress, _C_ontain, _O_ffer, _V_erify, _E_volve, _R_estore Treat errors as design material
AUTONOMY _A_ction, _U_ser, _T_iered, _O_bservable, _N_arrated, _O_utcome, _M_emory, _Y_ield Users supervise, AI executes
CALIBRATE _C_ommunicate, _A_nchor, _L_ayer, _I_nvite, _B_uild, _R_ecalibrate, _A_dapt, _T_rack, _E_volve Onboarding is calibration, not tutorial
SIGNAL _S_urface, _I_ncentivize, _G_raduate, _N_arrate, _A_ggregate, _L_oop Feedback is a transaction — close the loop
CRAFT _C_onstrain, _R_eveal, _A_ssist, _F_ormat, _T_each A blank text box is not a prompt UX
ADAPT _A_gency, _D_ata, _A_lternatives, _P_atterns, _T_ested Personalization is a power dynamic
SHIELD _S_cope, _H_uman, _I_nform, _E_scalation, _L_og, _D_egrade Safety and usability are not opposites
PATHWAY _P_erception, _A_utonomy, _T_rust, _H_elp, _W_ow, _A_nxiety, _Y_ield Map what users BELIEVE, not just what they DO
RENDER _R_ight, _E_asy, _N_avigable, _D_irectly, _E_ditable, _R_eproducible AI generates output. Humans consume meaning

Quick-Start Workflows

Designing a New AI Chat Product

ai-onboarding-calibration → ai-prompt-ux → ai-conversation-architect →
ai-trust-transparency → ai-error-resilience → ai-feedback-loops

Designing an AI Agent Experience

ai-journey-mapper → ai-agent-ux → ai-safety-guardrails →
ai-trust-transparency → ai-feedback-loops

Auditing an Existing AI Product

ai-journey-mapper → ai-trust-transparency → ai-error-resilience →
ai-safety-guardrails → ai-personalization-ethics

Improving AI Adoption & Retention

ai-onboarding-calibration → ai-journey-mapper → ai-feedback-loops →
ai-personalization-ethics

Installation

Each skill is a standalone SKILL.md file that can be installed into your Claude Code or GitHub Copilot environment.

Claude Code

# Clone this repo
git clone https://github.com/varunk130/ai-ux-skill-library.git

# Copy all skills to your Claude Code skills directory
cp -r ai-ux-skill-library/skills/* ~/.claude/skills/

# Or install a single skill
cp -r ai-ux-skill-library/skills/ai-agent-ux ~/.claude/skills/

GitHub Copilot

# Clone this repo
git clone https://github.com/varunk130/ai-ux-skill-library.git

# Copy all skills to your GitHub Copilot instructions directory
cp -r ai-ux-skill-library/skills/* .github/skills/

# Or install a single skill
cp -r ai-ux-skill-library/skills/ai-agent-ux .github/skills/

What Makes These Skills Unique

  1. AI-only problems — Every skill targets a UX challenge that does NOT exist in traditional software (trust arcs, hallucination recovery, autonomy dials)
  2. Proprietary frameworks — Each skill has a named, mnemonic framework (DIALOGUE, GLASS, RECOVER, etc.) with original scoring rubrics and decision matrices
  3. Anti-pattern catalogs — Every skill includes specific anti-patterns with explanations of why they fail, not just best practices
  4. Cross-skill integration — Skills reference each other, creating a composable system where outputs from one skill feed into another
  5. Opinionated defaults — Specific numbers, thresholds, and recommendations rather than "it depends" advice

Directory Structure

ai-ux-skill-library/
├── README.md
├── LICENSE
└── skills/
    ├── ai-conversation-architect/SKILL.md   # DIALOGUE Framework
    ├── ai-trust-transparency/SKILL.md       # GLASS Framework
    ├── ai-error-resilience/SKILL.md         # RECOVER Framework
    ├── ai-agent-ux/SKILL.md                 # AUTONOMY Framework
    ├── ai-onboarding-calibration/SKILL.md   # CALIBRATE Framework
    ├── ai-feedback-loops/SKILL.md           # SIGNAL Framework
    ├── ai-prompt-ux/SKILL.md                # CRAFT Framework
    ├── ai-personalization-ethics/SKILL.md   # ADAPT Framework
    ├── ai-safety-guardrails/SKILL.md        # SHIELD Framework
    ├── ai-journey-mapper/SKILL.md           # PATHWAY Framework
    └── ai-multimodal-output/SKILL.md        # RENDER Framework (Bonus)

Contributing

We welcome contributions! To add or improve a skill:

  1. Fork this repository
  2. Create a feature branch (git checkout -b improve-skill-name)
  3. Update the SKILL.md in the relevant skill directory
  4. Submit a Pull Request with a description of your changes

License

This project is licensed under the MIT License.


Built by Varun Kulkarni

Powered by Claude Code & GitHub Copilot

About

The 11-Skill AI UX Design Engine for Claude Code & GitHub Copilot — purpose-built skills for designing UX for AI products, AI agents, and AI-powered experiences

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors