Communitygithub.com

ulasalyesil/personal-website-v2

Réalisez des audits d'accessibilité WCAG 2.2 avec tests automatisés, vérification manuelle et conseils de correction. À utiliser pour auditer l'accessibilité de sites web, corriger des violations WCAG ou implémenter des motifs de conception accessibles.

Qu'est-ce que personal-website-v2 ?

Cette compétence fournit un guide complet pour auditer le contenu web selon les directives WCAG 2.2, avec des stratégies de correction actionnables. Elle couvre tous les niveaux de conformité (A, AA, AAA) et les quatre principes POUR (Perceptible, Utilisable, Compréhensible, Robuste). L'audit inclut une checklist détaillée par principe, des exemples de code HTML/CSS/JavaScript pour les bonnes et mauvaises pratiques, ainsi que des intégrations d'outils de test automatisé comme axe-core, Pa11y et Lighthouse. La compétence est utile pour les développeurs, testeurs et spécialistes de l'accessibilité qui doivent corriger des violations, préparer des audits légaux (ADA, Section 508, VPAT) ou implémenter des composants accessibles. Elle propose également des motifs de correction concrets pour les problèmes courants : labels de formulaire, contraste des couleurs, navigation clavier, etc.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/wcag-audit-patterns

Demander à votre IA préférée

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

Aperçu

Depuis le README du skill

personal-website-v2 preview
personal-website-v2 preview

Documentation

Modèles d'audit WCAG

Guide complet pour auditer le contenu web selon les directives WCAG 2.2, avec des stratégies de correction actionnables.

Quand utiliser cette compétence

  • Réaliser des audits d'accessibilité
  • Corriger des violations WCAG
  • Implémenter des composants accessibles
  • Se préparer à des poursuites liées à l'accessibilité
  • Satisfaire aux exigences ADA/Section 508
  • Atteindre la conformité VPAT

Concepts fondamentaux

1. Niveaux de conformité WCAG

NiveauDescriptionRequis pour
AAccessibilité minimaleBase légale
AAConformité standardLa plupart des réglementations
AAAAccessibilité renforcéeBesoins spécialisés

2. Principes POUR

Perceptible :  Les utilisateurs peuvent-ils percevoir le contenu ?
Utilisable :   Les utilisateurs peuvent-ils utiliser l'interface ?
Compréhensible : Les utilisateurs peuvent-ils comprendre le contenu ?
Robuste :      Fonctionne-t-il avec les technologies d'assistance ?

3. Violations courantes par impact

Critiques (Blocants) :
├── Texte alternatif manquant pour les images fonctionnelles
├── Pas d'accès clavier aux éléments interactifs
├── Étiquettes de formulaire manquantes
└── Médias en lecture automatique sans contrôles

Graves :
├── Contraste de couleur insuffisant
├── Liens d'évitement manquants
├── Widgets personnalisés inaccessibles
└── Titres de page manquants

Modérées :
├── Attribut de langue manquant
├── Texte de lien peu clair
├── Points de repère manquants
└── Hiérarchie de titres incorrecte

Liste de contrôle d'audit

Perceptible (Principe 1)

## 1.1 Équivalents textuels

### 1.1.1 Contenu non textuel (Niveau A)

- [ ] Toutes les images ont un texte alternatif
- [ ] Les images décoratives ont alt=""
- [ ] Les images complexes ont des descriptions longues
- [ ] Les icônes avec signification ont des noms accessibles
- [ ] Les CAPTCHAs ont des alternatives

Vérification :

```html
<!-- Bon -->
<img src="chart.png" alt="Les ventes ont augmenté de 25% du T1 au T2" />
<img src="decorative-line.png" alt="" />

<!-- Mauvais -->
<img src="chart.png" />
<img src="decorative-line.png" alt="ligne décorative" />
```

1.2 Médias temporels

1.2.1 Audio seulement et Vidéo seulement (Niveau A)

  • L'audio a une transcription textuelle
  • La vidéo a une description audio ou une transcription

1.2.2 Sous-titres (Niveau A)

  • Toute vidéo a des sous-titres synchronisés
  • Les sous-titres sont précis et complets
  • Identification des intervenants incluse

1.2.3 Description audio (Niveau A)

  • La vidéo a une description audio pour le contenu visuel

1.3 Adaptable

1.3.1 Information et relations (Niveau A)

  • Les titres utilisent des balises appropriées (h1-h6)
  • Les listes utilisent ul/ol/dl
  • Les tableaux ont des en-têtes
  • Les entrées de formulaire ont des étiquettes
  • Points de repère ARIA présents

Vérification :

<!-- Hiérarchie de titres -->
<h1>Titre de page</h1>
<h2>Section</h2>
<h3>Sous-section</h3>
<h2>Autre section</h2>

<!-- En-têtes de tableau -->
<table>
  <thead>
    <tr>
      <th scope="col">Nom</th>
      <th scope="col">Prix</th>
    </tr>
  </thead>
</table>

1.3.2 Ordre significatif (Niveau A)

  • L'ordre de lecture est logique
  • Le positionnement CSS ne casse pas l'ordre
  • L'ordre de tabulation correspond à l'ordre visuel

1.3.3 Caractéristiques sensorielles (Niveau A)

  • Les instructions ne reposent pas uniquement sur la forme/la couleur
  • "Cliquez sur le bouton rouge" → "Cliquez sur Valider (bouton rouge)"

1.4 Distinguable

1.4.1 Utilisation de la couleur (Niveau A)

  • La couleur n'est pas le seul moyen de transmettre une information
  • Les liens sont distinguables sans couleur
  • Les états d'erreur ne se basent pas uniquement sur la couleur

1.4.3 Contraste (Minimum) (Niveau AA)

  • Texte : rapport de contraste de 4,5:1
  • Grand texte (18pt+) : rapport de 3:1
  • Composants UI : rapport de 3:1

Outils : Vérificateur de contraste WebAIM, axe DevTools

1.4.4 Redimensionnement du texte (Niveau AA)

  • Le texte se redimensionne à 200% sans perte
  • Pas de défilement horizontal à 320px
  • Le contenu se réorganise correctement

1.4.10 Réorganisation (Niveau AA)

  • Le contenu se réorganise à 400% de zoom
  • Pas de défilement bidimensionnel
  • Tout le contenu est accessible à 320px de largeur

1.4.11 Contraste du contenu non textuel (Niveau AA)

  • Les composants UI ont un contraste de 3:1
  • Les indicateurs de focus sont visibles
  • Les objets graphiques sont distinguables

1.4.12 Espacement du texte (Niveau AA)

  • Pas de perte de contenu avec un espacement accru
  • Hauteur de ligne de 1,5x la taille de police
  • Espacement de paragraphe de 2x la taille de police
  • Espacement des lettres de 0,12x la taille de police
  • Espacement des mots de 0,16x la taille de police

### Utilisable (Principe 2)

```markdown
## 2.1 Accessible au clavier

### 2.1.1 Clavier (Niveau A)
- [ ] Toute fonctionnalité accessible au clavier
- [ ] Pas de piège clavier
- [ ] L'ordre de tabulation est logique
- [ ] Les widgets personnalisés sont opérables au clavier

Vérification :
```javascript
// Un bouton personnalisé doit être accessible au clavier
<div role="button" tabindex="0"
     onkeydown="if(event.key === 'Enter' || event.key === ' ') activate()">
```

### 2.1.2 Pas de piège clavier (Niveau A)

- [ ] Le focus peut être déplacé de tout composant
- [ ] Les boîtes de dialogue modales capturent correctement le focus
- [ ] Le focus revient après la fermeture de la fenêtre modale

## 2.2 Délai suffisant

### 2.2.1 Ajustement du délai (Niveau A)

- [ ] Les délais de session peuvent être prolongés
- [ ] L'utilisateur est averti avant l'expiration
- [ ] Option pour désactiver l'actualisation automatique

### 2.2.2 Pause, arrêter, masquer (Niveau A)

- [ ] Le contenu en mouvement peut être mis en pause
- [ ] Le contenu mis à jour automatiquement peut être mis en pause
- [ ] Les animations respectent prefers-reduced-motion

```css
@media (prefers-reduced-motion: reduce) {
  * {
    animation: none !important;
    transition: none !important;
  }
}
```

## 2.3 Convulsions et réactions physiques

### 2.3.1 Trois flashs (Niveau A)

- [ ] Aucun contenu ne flashe plus de 3 fois par seconde
- [ ] La zone de flash est petite (<25% de la zone d'affichage)

## 2.4 Navigable

### 2.4.1 Contournement des blocs (Niveau A)

- [ ] Lien pour passer au contenu principal présent
- [ ] Régions de point de repère définies
- [ ] Structure de titres appropriée

```html
<a href="#main" class="skip-link">Passer au contenu principal</a>
<main id="main">...</main>
```

### 2.4.2 Titre de page (Niveau A)

- [ ] Titres de page uniques et descriptifs
- [ ] Le titre reflète le contenu de la page

### 2.4.3 Ordre de tabulation (Niveau A)

- [ ] L'ordre de tabulation correspond à l'ordre visuel
- [ ] tabindex utilisé correctement

### 2.4.4 Objectif du lien (en contexte) (Niveau A)

- [ ] Les liens ont du sens hors contexte
- [ ] Pas de "cliquez ici" ou "en savoir plus" seul

```html
<!-- Mauvais -->
<a href="report.pdf">Cliquez ici</a>

<!-- Bon -->
<a href="report.pdf">Télécharger le rapport des ventes T4 (PDF)</a>
```

### 2.4.6 Titres et étiquettes (Niveau AA)

- [ ] Les titres décrivent le contenu
- [ ] Les étiquettes décrivent le but

### 2.4.7 Focus visible (Niveau AA)

- [ ] Indicateur de focus visible sur tous les éléments
- [ ] Les styles de focus personnalisés respectent le contraste

```css
:focus {
  outline: 3px solid #005fcc;
  outline-offset: 2px;
}
```

### 2.4.11 Focus non masqué (Niveau AA) - WCAG 2.2

- [ ] L'élément focalisé n'est pas complètement caché
- [ ] Les en-têtes fixes ne masquent pas le focus

Compréhensible (Principe 3)

## 3.1 Lisible

### 3.1.1 Langue de la page (Niveau A)
- [ ] Attribut lang HTML défini
- [ ] La langue est correcte pour le contenu

```html
<html lang="fr">

3.1.2 Langue des passages (Niveau AA)

  • Les changements de langue sont marqués
<p>Le mot anglais <span lang="en">hello</span> signifie bonjour.</p>

3.2 Prévisible

3.2.1 Au focus (Niveau A)

  • Pas de changement de contexte sur le seul focus
  • Pas de popups inattendues au focus

3.2.2 À l'entrée (Niveau A)

  • Pas de soumission automatique de formulaire
  • L'utilisateur est averti avant le changement de contexte

3.2.3 Navigation cohérente (Niveau AA)

  • Navigation cohérente sur toutes les pages
  • Composants répétés dans le même ordre

3.2.4 Identification cohérente (Niveau AA)

  • Même fonctionnalité = même étiquette
  • Icônes utilisées de manière cohérente

3.3 Assistance à la saisie

3.3.1 Identification des erreurs (Niveau A)

  • Les erreurs sont clairement identifiées
  • Le message d'erreur décrit le problème
  • L'erreur est liée au champ
<input aria-describedby="email-error" aria-invalid="true" />
<span id="email-error" role="alert">Veuillez saisir un email valide</span>

3.3.2 Étiquettes ou instructions (Niveau A)

  • Toutes les entrées ont des étiquettes visibles
  • Les champs obligatoires sont indiqués
  • Indications de format fournies

3.3.3 Suggestion d'erreur (Niveau AA)

  • Les erreurs incluent une suggestion de correction
  • Les suggestions sont spécifiques

3.3.4 Prévention des erreurs (Niveau AA)

  • Les formulaires juridiques/financiers sont réversibles
  • Les données sont vérifiées avant soumission
  • L'utilisateur peut examiner avant de soumettre

### Robuste (Principe 4)

```markdown
## 4.1 Compatible

### 4.1.1 Analyse (Niveau A) - Obsolète dans WCAG 2.2
- [ ] HTML valide (bonne pratique)
- [ ] Pas d'IDs en double
- [ ] Balises d'ouverture/fermeture complètes

### 4.1.2 Nom, rôle, valeur (Niveau A)
- [ ] Les widgets personnalisés ont des noms accessibles
- [ ] Rôles ARIA corrects
- [ ] Les changements d'état sont annoncés

```html
<!-- Case à cocher personnalisée accessible -->
<div role="checkbox"
     aria-checked="false"
     tabindex="0"
     aria-labelledby="label">
</div>
<span id="label">Accepter les conditions</span>
```

### 4.1.3 Messages d'état (Niveau AA)

- [ ] Les mises à jour d'état sont annoncées
- [ ] Les régions live sont utilisées correctement

```html
<div role="status" aria-live="polite">3 articles ajoutés au panier</div>

<div role="alert" aria-live="assertive">Erreur : Échec de la soumission du formulaire</div>
```

Tests automatisés

// Intégration axe-core
const axe = require('axe-core');

async function runAccessibilityAudit(page) {
  await page.addScriptTag({ path: require.resolve('axe-core') });

  const results = await page.evaluate(async () => {
    return await axe.run(document, {
      runOnly: {
        type: 'tag',
        values: ['wcag2a', 'wcag2aa', 'wcag21aa', 'wcag22aa']
      }
    });
  });

  return {
    violations: results.violations,
    passes: results.passes,
    incomplete: results.incomplete
  };
}

// Exemple de test Playwright
test('ne doit pas avoir de violations d'accessibilité', async ({ page }) => {
  await page.goto('/');
  const results = await runAccessibilityAudit(page);

  expect(results.violations).toHaveLength(0);
});
# Outils CLI
npx @axe-core/cli https://exemple.com
npx pa11y https://exemple.com
lighthouse https://exemple.com --only-categories=accessibility

Modèles de correction

Correction : Étiquettes de formulaire manquantes

<!-- Avant -->
<input type="email" placeholder="Email" />

<!-- Après : Option 1 - Étiquette visible -->
<label for="email">Adresse email</label>
<input id="email" type="email" />

<!-- Après : Option 2 - aria-label -->
<input type="email" aria-label="Adresse email" />

<!-- Après : Option 3 - aria-labelledby -->
<span id="email-label">Email</span>
<input type="email" aria-labelledby="email-label" />

Correction : Contraste de couleur insuffisant

/* Avant : 2,5:1 de contraste */
.text {
  color: #767676;
}

/* Après : 4,5:1 de contraste */
.text {
  color: #595959;
}

/* Ou ajouter un fond */
.text {
  color: #767676;
  background: #000;
}

Correction : Navigation au clavier

// Rendre un élément personnalisé accessible au clavier
class AccessibleDropdown extends HTMLElement {
  connectedCallback() {
    this.setAttribute("tabindex", "0");
    this.setAttribute("role", "combobox");
    this.setAttribute("aria-expanded", "false");

    this.addEventListener("keydown", (e) => {
      switch (e.key) {
        case "Enter":
        case " ":
          this.toggle();
          e.preventDefault();
          break;
        case "Escape":
          this.close();
          break;
        case "ArrowDown":
          this.focusNext();
          e.preventDefault();
          break;
        case "ArrowUp":
          this.focusPrevious();
          e.preventDefault();
          break;
      }
    });
  }
}

Bonnes pratiques

À faire

  • Commencer tôt - Accessibilité dès la phase de conception
  • Tester avec des utilisateurs réels - Les personnes handicapées fournissent les meilleurs retours
  • Automatiser ce qui peut l'être - 30 à 50% des problèmes détectables
  • Utiliser du HTML sémantique - Réduit les besoins en ARIA
  • Documenter les modèles - Créer une bibliothèque de composants accessibles

À ne pas faire

  • Ne pas se fier uniquement aux tests automatisés - Les tests manuels sont nécessaires
  • Ne pas utiliser ARIA comme première solution - Privilégier le HTML natif d'abord
  • Ne pas masquer les contours de focus - Les utilisateurs du clavier en ont besoin
  • Ne pas désactiver le zoom - Les utilisateurs doivent pouvoir redimensionner
  • Ne pas utiliser la couleur seule - Plusieurs indicateurs nécessaires

Ressources

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

Skills associés