Skip to content

Gentleman-Programming/gentle-shell / skills/gentle-ui-design

gentle-ui-design

Verified

Trigger: product interface design, web UI, design critique, browsing experience, responsive layout. Guide usable interfaces for the current project.

---
name: gentle-ui-design
description: "Trigger: product interface design, web UI, design critique, browsing experience, responsive layout. Guide usable interfaces for the current project."
license: Apache-2.0
metadata:
  author: gentleman-programming
  version: "1.0"
---

## Activation Contract

Use for web and product interfaces when shaping, implementing, or assessing a user experience. Pair with `gentle-design` when producing artboards: gentle-design owns delivery, this skill owns UX quality. Use `gentle-ai-tui-design` for terminal interfaces.

## Hard Rules

- Keep a read-only critique read-only; do not install tools or dependencies for this guidance.
- Establish the user's job and success condition before appearance. Ask only when missing intent would materially change a decision.
- Reuse the project's brand, components, and platform conventions; avoid universal aesthetic bans.
- Do not invent evidence or conceal inaccessible controls. Model real content ranges and states; this guidance adds no hooks, detectors, or mandatory tool chains.

## Decision Gates

| Need or symptom | Load and apply |
| --- | --- |
| Unclear purpose, weak copy, or generic direction | `references/task-and-content.md` |
| Search, large collections, or difficult comparison | `references/browse-and-compare.md` |
| Flat hierarchy, clutter, or weak feedback | `references/composition-and-feedback.md` |
| Narrow screens, input access, or missing states | `references/adaptive-interfaces.md` |

## Execution Steps

1. Identify the audience, primary job, constraints, and likely content sizes; inspect existing project conventions when available.
2. Load only the relevant references and select defaults or justified exceptions for the task.
3. Apply the project's visual language and account for touch, keyboard, focus, contrast, and reduced motion.
4. Inspect visually when useful and authorized; report observations rather than implying an inspection occurred.

## Output Contract

Summarize design choices and tradeoffs, files changed if any, checks actually performed, and important unknowns.

## References

- `references/task-and-content.md` — purpose, information architecture, art direction, and truthful copy.
- `references/browse-and-compare.md` — search, collection scale, comparison, and navigation state.
- `references/composition-and-feedback.md` — hierarchy, density, color, type, and visual feedback.
- `references/adaptive-interfaces.md` — responsive behavior, accessible interaction, and states.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall