agentsclimarketplace

Ai trust transparency

Skill varunk130/ai-ux-skill-library/skills/ai-trust-transparency

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-trust-transparency

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 explainability interfaces that help users understand AI decisions, build calibrated trust, and verify AI outputs. Use when: AI explainability, XAI UX, confidence indicators, citation design, source attribution, trust signals, AI transparency, why did AI do this.

SKILL.md

8.5 KB, as published. Nobody here has run it

AI Trust & Transparency

Design interfaces where users can see into the AI's reasoning, calibrate their trust appropriately, and verify claims independently. The GLASS framework makes AI decision-making visible without overwhelming users.

Core Principle

Trust is not a boolean. Users should not "trust AI" or "distrust AI" - they should develop calibrated trust: high confidence when the AI is reliable, healthy skepticism when it's uncertain. Your job is to give them the signals to calibrate correctly.


The GLASS Framework

LetterPrincipleDesign Question
GGround in SourcesCan the user trace every AI claim back to a verifiable source?
LLayer ExplanationsCan the user get a 5-second answer AND a 5-minute deep dive?
AAdvertise LimitationsDoes the interface proactively tell users what the AI is NOT good at?
SShow ConfidenceCan the user see how certain the AI is about each output?
SSupport OverrideCan the user correct, override, or reject AI outputs without friction?

The Trust Calibration Spectrum

Design for the right trust level - not maximum trust.

Trust LevelUser BehaviorDesign GoalWhen Appropriate
Over-trust (Automation Bias)Accepts all AI outputs without checkingIntroduce friction to encourage verificationHigh-stakes decisions (medical, financial, legal)
Calibrated TrustVerifies selectively based on confidence signalsMaintain - this is the target stateMost AI interactions
Under-trust (AI Aversion)Rejects AI outputs even when correctBuild trust incrementally through track recordNew users, after AI failures

Trust Erosion Events (TEEs)

A single trust violation can undo weeks of reliable performance. Design for recovery:

TEE TypeExampleRecovery Pattern
Confident hallucinationAI states a false fact with no hedgingImmediately acknowledge the error class; show what changed to prevent recurrence
Silent failureAI gives an answer but misses a critical constraintAdd constraint-checking signals: "I accounted for X, Y, Z in this answer"
InconsistencyAI gives different answers to the same questionSurface version/context differences: "This differs from my earlier answer because..."
OpacityUser cannot understand why AI made a choiceRetroactive explanation: "I recommended X because of [factors]. Here's what would change if..."

Confidence Display Patterns

The Confidence Triad

Every AI output should communicate three dimensions of confidence:

DimensionWhat It Tells the UserDisplay Pattern
CertaintyHow sure is the AI about this specific output?Color-coded badge (green/amber/red) + percentage if available
BasisWhat evidence supports this output?Inline citations, source cards, "Based on..." prefix
ScopeWhat does this answer cover, and what doesn't it cover?Explicit boundary statements: "This covers X but does not account for Y"

Confidence Display Decision Matrix

ContextShow Numerical Confidence?Show Color Badge?Show Source Links?
Casual information lookupNo - feels clinicalOptionalYes, inline
Professional decision supportYes - precision mattersYesYes, with expandable detail
Creative generation (writing, images)No - subjectivity makes numbers misleadingNoShow inspiration sources if applicable
Code generationYes (test pass rate)YesLink to documentation used
Medical/legal/financialYes - accountability demands itYes, conservative (amber default)Mandatory, with recency indicator

Citation Architecture

Citations are the single highest-impact trust pattern for LLM-based products.

Citation Depth Levels

LevelWhat Users SeeWhen to Use
L0: No citationRaw AI outputOnly for creative/casual use cases with no factual claims
L1: Source attribution"Based on [source name]"Minimum for any factual claim
L2: Inline citationNumbered references linked to specific claimsProfessional, research, and decision-support contexts
L3: Quotable evidenceDirect excerpts from sources with highlightingHigh-stakes contexts where users must verify independently
L4: Auditable traceFull reasoning chain + every source consulted + sources rejectedRegulated industries, compliance, legal discovery

Citation UI Patterns

PatternImplementationBest For
Superscript numbersClaim text[1] with footnotesLong-form responses, research
Inline source chips"According to WHO Guidelines 2025..."Conversational interfaces
Expandable evidence cardsCollapsed by default, expand to show excerpt + linkDecision-support dashboards
Side-panel source viewerClick citation, source appears in adjacent panelDocument review, analysis tools
Confidence-colored highlightsText segments colored by source reliabilityProfessional research tools

Explanation Layering

Different users need different explanation depths at different moments. Design explanations that telescope from simple to deep.

The 5-Second / 5-Minute / 50-Minute Rule

LayerDepthContentUI Pattern
5-secondHeadlineOne sentence: what the AI did and its confidenceAlways visible - the response itself
5-minuteSummaryKey factors that influenced the output, top 3 reasonsExpandable section: "Why this answer?"
50-minuteAudit trailFull reasoning chain, all sources consulted, alternative answers consideredLink to detailed view or export

Anti-pattern: Dumping all three layers at once. The 50-minute layer should never appear unless explicitly requested.


The "Why?" Menu

Every non-trivial AI output should support a "Why?" interaction:

"Why?" QuestionWhat to Show
"Why this answer?"Top 3 factors that influenced the output
"Why not [alternative]?"What would need to change for the alternative to be recommended
"What are you uncertain about?"Specific elements with lower confidence + what additional info would help
"What did you ignore?"Factors the AI considered but deprioritized, and why
"How would this change if...?"Sensitivity: what inputs would flip the recommendation

Anti-Patterns

PatternWhy It Fails
Showing confidence scores without context"87% confidence" means nothing without a baseline. Is 87% good or bad for this task?
Using green for everythingIf all outputs are green-badged, the badge system is meaningless. Users need contrast to calibrate
Burying explanations behind 3+ clicksIf users can't reach the "why" in one interaction, they won't bother
Making citations look like legal disclaimersDense, tiny-font footnotes signal "cover our liability" not "verify this yourself"
Explaining the model instead of the decisionUsers don't care about transformer architecture. They care about "why THIS recommendation for MY situation"
Only explaining when wrongIf explanations only appear after errors, users associate explanation UI with unreliability

Quick Reference

TaskFramework ElementKey Deliverable
Add explainability to AI productFull GLASS frameworkExplanation layer architecture + citation depth map
Design confidence indicatorsConfidence Triad + Display MatrixVisual system with color, basis, and scope signals
Recover from trust violationTrust Erosion Events tableRecovery flow with acknowledgment, explanation, and prevention
Audit an AI product for transparencyTrust Calibration SpectrumAssessment of where users fall on the spectrum + design interventions
Add citations to LLM outputsCitation Architecture (L0-L4)Citation system matched to use case risk level

Integration

Works with: ai-error-resilience (transparency about failures), ai-conversation-architect (confidence in dialogue), ai-safety-guardrails (transparency about content filtering), ai-feedback-loops (user corrections as trust 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.