Gentleman-Programming/gentle-shell / skills/gentle-ui-design
gentle-ui-design
VerifiedTrigger: product interface design, web UI, design critique, browsing experience, responsive layout. Guide usable interfaces for the current project.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.5 KB |
| references/adaptive-interfaces.md | markdown | 3.5 KB |
| references/browse-and-compare.md | markdown | 4.7 KB |
| references/composition-and-feedback.md | markdown | 4.4 KB |
| references/task-and-content.md | markdown | 4.2 KB |
references/task-and-content.md
View on GitHub# Task and content
## Start with the job
Choose the first screen by what the person needs to do, not by a favorite page template.
A single product may contain several of these jobs; identify the leading job for the current surface.
| Job | Give priority to | A useful outcome |
| --- | --- | --- |
| Find | Search scope, filters, recognizable results | Reach the intended item without inspecting every entry |
| Compare | Shared attributes and a stable order | Understand meaningful differences before choosing |
| Act | Current state, the primary action, and consequences | Complete the operation without losing context |
| Read | A clear heading, readable text, and wayfinding | Understand the information and find a passage again |
| Decide | The proposition, relevant evidence, and next step | Make a choice with the information available |
For a work surface, put the working controls and current material in the initial viewport.
A large promotional hero ahead of an existing user's records makes a routine action take longer.
A compact orientation banner can help a new user, but it should not permanently displace the work.
For a public introduction, a prominent opening can instead explain what the offering does and for whom.
Arrange navigation around the objects and tasks people recognize.
For example, a shared workshop app could group **Reservations**, **Tools**, and **Members** rather than burying them under internal department names.
Keep the main action near its object: **Reserve tool** belongs with availability, not inside an unrelated settings menu.
If an action has an irreversible consequence, show that consequence before it is committed.
Avoid showing several equally prominent primary actions when one is the normal next step; preserve alternatives as clearly labeled secondary actions.
## Specific, truthful content
Use exact labels that predict the outcome and match what the system actually does.
A generic label forces the user to open or guess; a specific one makes the choice legible.
| Weak | Better when accurate | Why |
| --- | --- | --- |
| `Continue` | `Review reservation` | Names the next stage without promising completion |
| `Manage` | `Change pickup time` | Explains which operation is available |
| `Something went wrong` | `Reservation not saved. Try again.` | States the consequence and a useful next action |
| `The future of shared spaces` | `Book workshop tools for your next project` | Identifies the audience's activity |
Do not invent customer identities, quotes, usage figures, charts, or claims of measured results.
Use real evidence only when it is available and appropriate to disclose.
Label illustrative records as demonstration data and avoid presenting them as actual customers or outcomes.
If no evidence exists, explain the capability plainly instead of manufacturing social proof.
When the actual next action depends on missing product intent, ask that focused question rather than assembling a broad questionnaire.
## Give the interface a reasoned visual idea
Take a cue from the subject and make it useful across the surface, not just in a headline.
For a workshop booking page, a calm timetable with clear availability can express the practical, shared nature of the service;
for a reading archive, a quiet index and legible excerpts may communicate its purpose more effectively.
Use the project's established palette, type, shapes, and components as the starting vocabulary.
A coherent direction comes from decisions about emphasis, content, and layout, not merely from removing shadows or decoration.
Inventory authentic material already available before deciding that a design needs prominent imagery.
An accurate diagram, product image, or real document can explain an offering; a fabricated screenshot or unrelated stock image can mislead.
When suitable assets are unavailable, use a purposeful text-led composition instead of pretending the product has imagery it does not.
Do not fetch remote assets automatically. If sourcing is explicitly authorized, track the relevant usage rights.
Let content dictate whether sections vary or repeat.
A narrative can change rhythm when its subject changes; a sequence of comparable options benefits from the same structure.
Neither a different layout for every section nor identical blocks everywhere is a universal rule.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |