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.

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 symptomLoad and apply
Unclear purpose, weak copy, or generic directionreferences/task-and-content.md
Search, large collections, or difficult comparisonreferences/browse-and-compare.md
Flat hierarchy, clutter, or weak feedbackreferences/composition-and-feedback.md
Narrow screens, input access, or missing statesreferences/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: 319kUpdated 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: 196kUpdated 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: 196kUpdated 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: 196kUpdated Claude CodeCodexVerifiedInstall