Communitygithub.com

make-interfaces-feel-better

Appliquez des détails concrets de conception et d'ingénierie qui rendent les interfaces plus soignées. À utiliser lors de la révision ou de l'amélioration de l'espacement UI, de la typographie, des bordures, des ombres, des animations, des zones de clic, des icônes, du retour à la ligne et des états d'interaction.

Qu'est-ce que make-interfaces-feel-better ?

Cette compétence est conçue pour les développeurs et les designers souhaitant affiner les interfaces utilisateur en se concentrant sur des détails spécifiques de design-engineering. Elle compile des principes concrets tels que le rayon concentrique, l'alignement optique, les ombres et bordures adaptées, le wrapping de texte (text-wrap: balance et pretty), le lissage de police, les contours d'image invisibles, et les animations CSS avec des transitions explicites. Utile pour les plateformes de développement web (React, Vue, frameworks CSS génériques) et les environnements de conception UI, cette compétence vous guide pour appliquer des améliorations cohérentes et subtiles qui rendent une interface plus polie. Fonctionne en listant les principes à vérifier et en fournissant des exemples CSS avant/après pour chaque modification, ce qui facilite l'intégration dans des revues de code ou des sessions de conception. L'objectif est d'éviter les interfaces génériques, rigides ou mal finies en apportant des corrections précises basées sur l'optique visuelle et la réactivité des composants.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/make-interfaces-feel-better

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Améliorer le ressenti des interfaces

Utilisez cette compétence pour les petits détails de design-engineering qui se cumulent pour créer une interface plus soignée.

Source : récupérée de la PR communautaire obsolète #1659 par linus707.

Quand l’utiliser

  • L’utilisateur dit que l’UI semble étrange, plate, générique, serrée, saccadée ou inachevée.
  • Vous construisez des contrôles, des cartes, des listes, des tableaux de bord, de la navigation, des formulaires ou des barres d’outils.
  • Un composant a besoin d’états de survol, actif, focus, entrée, sortie, chargement ou vide.
  • Une revue frontend nécessite des recommandations spécifiques avant/après.

Principes fondamentaux

Rayon concentrique

Pour les surfaces arrondies imbriquées proches :

rayon extérieur = rayon intérieur + espacement

Si l’espacement est grand, traitez les couches comme des surfaces séparées au lieu de forcer le calcul. L’objectif est la cohérence optique, pas le respect absolu de la formule.

Alignement optique

Le centrage géométrique n’est pas toujours le centrage visuel. Les boutons d’icônes, les triangles de lecture, les flèches, les étoiles et les icônes asymétriques nécessitent souvent un petit décalage. Corrigez le SVG quand c’est possible ; sinon ajustez avec une marge ou un padding au niveau du pixel.

Ombres et bordures

Utilisez des bordures pour la séparation et les anneaux de focus. Utilisez des ombres superposées quand une carte, un bouton, un menu déroulant ou une popover a besoin de profondeur. Les ombres doivent être transparentes et suffisamment subtiles pour fonctionner sur tous les arrière-plans.

Habillage du texte

  • Utilisez text-wrap: balance sur les titres et les titres courts.
  • Utilisez text-wrap: pretty sur les textes de corps courts à moyens, les légendes, les descriptions et les éléments de liste.
  • Évitez les deux sur les longs textes en prose, le code et le contenu préformaté.
  • Utilisez font-variant-numeric: tabular-nums pour les compteurs, minuteries, prix, tableaux et autres nombres mis à jour.

Lissage de police

Sur macOS, appliquez l’antialiasing de police lissé à la mise en page racine quand le projet ne le fait pas déjà :

html {
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

Contours des images

Les images ont souvent besoin d’un contour interne subtil pour que leurs bords ne se fondent pas dans la surface.

img {
  outline: 1px solid rgba(0, 0, 0, 0.1);
  outline-offset: -1px;
}

@media (prefers-color-scheme: dark) {
  img {
    outline-color: rgba(255, 255, 255, 0.1);
  }
}

Utilisez des contours alpha neutres noirs ou blancs. Ne teintez pas les contours des images avec la palette de la marque.

Mouvement

Utilisez les transitions CSS pour les changements d’état interactifs car elles peuvent être redirigées lorsque l’utilisateur change d’intention en cours de mouvement. Réservez les images clés pour les entrées uniques scénarisées ou les séquences de chargement.

Bons réglages par défaut pour le mouvement :

  • Entrée : combinez opacité, petit translateY et éventuellement flou.
  • Sortie : plus court et plus discret que l’entrée, généralement 150 ms.
  • Pression : scale(0.96) pour les boutons tactiles, avec un moyen de le désactiver lorsque le mouvement distrait.
  • Échanges d’icônes : fondu enchaîné avec opacité, échelle et flou au lieu de bascules de visibilité instantanées.

Portée des transitions

N’utilisez jamais transition: all. Spécifiez les propriétés modifiées :

.button {
  transition-property: transform, background-color, box-shadow;
  transition-duration: 150ms;
  transition-timing-function: ease-out;
}

Utilisez will-change uniquement pour le scintillement de la première image sur les propriétés compatibles avec le compositeur telles que transform, opacity et filter. N’utilisez jamais will-change: all.

Zones de clic

Les contrôles interactifs doivent avoir au moins une zone de clic de 40x40 px, idéalement 44x44 px là où la mise en page le permet. Agrandissez avec un pseudo-élément lorsque l’icône visible est plus petite, mais ne laissez pas les zones de clic étendues se chevaucher.

Sortie de revue

Lors de la révision d’une passe de polissage UI, rapportez les modifications concrètes sous forme de lignes avant/après :

PrincipeAvantAprès
Rayon concentriqueMême rayon sur parent et enfantLe rayon parent tient compte de l’espacement
Nombres tabulairesLe compteur se décale quand les chiffres changentLe compteur utilise tabular-nums
Portée des transitionstransition: allPropriétés de transition explicites

Incluez les chemins de fichier et les propriétés quand ils ne sont pas évidents d’après les extraits. Omettez les principes que vous avez vérifiés mais que vous n’avez pas modifiés.

Liste de vérification

  • Les éléments arrondis imbriqués sont optiquement cohérents.
  • Les icônes sont centrées visuellement.
  • Les boutons, cartes et popovers utilisent des bordures ou des ombres pour la bonne raison.
  • Les titres et les textes courts évitent les coupures maladroites.
  • Les nombres dynamiques utilisent des chiffres tabulaires.
  • Les images ont des contours neutres là où c’est nécessaire.
  • Les animations d’entrée et de sortie sont séparées, subtiles et interruptibles si approprié.
  • Les boutons ont des états actifs tactiles sans mouvement exagéré.
  • transition: all et will-change: all sont absents.
  • Les petits contrôles ont toujours des zones de clic utilisables.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

Skills associés