kienbui1995/magic-powers/ai-product-design
Claude Code and agent skill by kienbui1995/magic-powers
- community
Checking that the SKILL.md file is still in the repository.
Use when productizing AI features for end users — UX patterns for AI, streaming, loading states, error handling, fallback design, reliability, and responsible AI disclosure.
Install
npx vskill@latest install kienbui1995/magic-powers/ai-product-designSKILL.md
The same SKILL.md was published earlier as kienbui1995/magic-powers/ai-product-design.
AI Product Design
When to Use
- Designing UX for a chat, copilot, or AI-assisted feature
- Handling streaming responses, latency, and partial outputs
- Designing fallbacks when AI fails or is unavailable
- Writing AI disclosure and user trust patterns
- Planning reliability targets for an AI feature
Core Jobs
1. AI UX Patterns
2. Streaming Implementation
3. Error Handling & Fallbacks
4. Reliability Design
- SLA target for AI features: 200ms to first token (streaming) or 3s total
- Circuit breaker: fall back to cached/manual if AI error rate > 5%
- Caching: cache identical prompt+context combos (reduces cost + latency)
- Timeout: set explicit timeouts (10-30s max); never block UI indefinitely
- Queue: for batch operations, show progress not spinner
5. Responsible AI Disclosure
Required disclosures (per EU AI Act + emerging standards):
- Label AI-generated content clearly ("Generated by AI")
- Inform users when talking to AI vs human
- Provide opt-out for AI features
- Explain data usage for AI personalization
- Never claim AI is human when directly asked
6. Metrics to Track for AI Features
Agent UX Patterns
Showing agent work to users requires different UX than single-call AI:
Displaying agent progress:
Agent UX principles:
- Show steps in real-time (users trust agents they can see working)
- Reveal tools used: "I searched 3 sources" builds transparency
- Show intermediate results progressively (don't wait until full completion)
- Provide cancel option — users need control over long-running agents
- On failure: explain what was tried before failing ("I searched docs, tried 2 approaches, couldn't find...")
Displaying tool use transparently:
Collapsible by default — show on hover/expand for curious users.
Citation & Attribution
For RAG-generated content, attribution builds trust:
Implementation:
When to show citations:
- Always for factual claims (dates, numbers, names)
- Always for medical/legal/financial content
- Optional for stylistic/creative responses
- Always when user can verify the underlying source
Key Outputs
- UX spec: streaming behavior, loading states, error messages, fallback flow
- Reliability design: circuit breaker thresholds, timeout values, caching strategy
- Disclosure copy: AI labels, opt-out mechanism, data usage statement
- Metrics dashboard definition: acceptance rate, task completion, regeneration rate
Accessibility & Mobile
Accessibility for AI-specific UI elements:
Mobile patterns:
- Streaming on mobile: throttle updates to 100ms (not every token) — reduces reflow
- Loading states: skeleton screens better than spinners on small screens
- Error messages: use native alert dialogs (not toasts) on mobile — more visible
- Latency expectation: mobile users tolerate 5-8s more than desktop users (2-3s)
- Offline handling: queue AI requests when offline, process when reconnected
Internationalization of AI responses:
Anti-Patterns
- Blocking UI while waiting for AI response (always show progress)
- No fallback when AI fails (hard dependency = brittle feature)
- Hiding that content is AI-generated (trust violation)
- Treating AI output as ground truth without user verification step
- No feedback mechanism (users can't signal quality)
- Same spinner for 200ms vs 30s operations (calibrate expectation)
Integration
- Use with
ai-safety-guardrailsfor output safety before showing to user - Use with
llm-observabilityto monitor the metrics defined above - Use
prompt-engineeringto improve acceptance rate and reduce regenerations
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/ai-product-design/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/kienbui1995/magic-powers/ai-product-design)