Communitygithub.com

xzedm/clipplic-landing

UIコンポーネントのアクセシビリティエンジニアリングを支援するスキル。フォーカス状態、キーボードサポート、ARIA、フォーム、スクリーンリーダーを網羅し、「アクセシブルにして」というリクエストやキーボード・スクリーンリーダーの問題報告に対応します。

clipplic-landing とは?

このスキルは、製品インターフェースのアクセシビリティエンジニアリングを包括的にサポートします。フォーカス状態、キーボードナビゲーション、ARIA属性、フォームのラベル付けやエラーメッセージ、スクリーンリーダー対応など、WCAGガイドラインに沿った実装とレビューを提供します。Claude Code、Cursor、CodexなどのAIエージェント上で動作し、ユーザーが「アクセシブルにして」と依頼した場合や、キーボード操作・スクリーンリーダーの問題が報告された場合に自動的にトリガーされます。また、`better-colors`、`better-typography`、`better-layout`といった他のスキルと連携し、色のコントラスト、タイポグラフィ、レイアウトのRTL対応などを補完します。レビュー時には、まずキーボードのみで操作を確認し、次にスクリーンリーダーでナビゲーションを検証するという段階的なアプローチを取ります。出力は、問題の発見(重大度、場所、修正前後、理由)と検証結果・判定から構成されるスタンドアロンのアクセシビリティレビューレポートです。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/better-accessibility

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

クラフトに伴うアクセシビリティ

アクセシビリティは最後に付け加えるコンプライアンスのチェックボックスではありません。それはインターフェースクラフトの基盤です。プラットフォームを活用すれば、そのほとんどは無料で手に入ります。ネイティブ要素にはキーボードサポートが組み込まれ、適切なラベルは自動的に読み上げられ、可視のフォーカスリングは1つのCSSルールで実現できます。UIコードを構築・レビューする際にこれらの原則を適用し、修正を適用する際はプロジェクトの既存のスタイリングシステム(Tailwind、プレーンCSS、CSS-in-JS)に合わせてください。

レビュー時は、まずキーボードのみでユーザーとしてインターフェースを操作します(すべてのフローがマウスなしで完了できる必要があります)。次にスクリーンリーダーユーザーとして、各コントロールが名前、役割、状態を正しく読み上げるかを確認します。不明な場合は、カスタムで再構築するよりもプラットフォームのデフォルトを優先し、ARIAを追加するのではなく削除してください。

レンダリングペアのコントラスト測定と色の修正は better-colors スキル、視覚的なテキストサイズとiOSの入力ズームは better-typography、空間的なRTLレイアウトは better-layout がカバーします。

クイックリファレンス

カテゴリ使用するタイミング
フォーカスとキーボードフォーカスリング、スキップリンク、tabindex、フォーカストラップ、APGキーボードパターン
セマンティクスとARIAネイティブ要素を優先、button vs link、ランドマーク、アクセシブル名、無効状態
フォームラベル、オートコンプリート、エラーメッセージ、input type
スクリーンリーダー視覚的に隠されたコンテンツ、ライブリージョン、トースト、altテキスト、SVG
ヒットエリアターゲットサイズ、ヒットエリアの拡張、衝突ルール
モーションとズームprefers-reduced-motion、自動再生と時間指定UI、200%ズーム、リフロー、rem vs px

コア原則

1. ネイティブ要素を優先

ARIAの第一のルール:ネイティブ要素が存在する場合はARIAを使用しないこと。アクションには <button>、ナビゲーションには <a href>(Cmd/Ctrl/ミドルクリックをサポートする必要があります)、<div onClick> は絶対に使用しないでください。ARIAがないことは、悪いARIAよりも優れています。

2. 可視のフォーカスリング

:focus ではなく :focus-visible をスタイル設定します。これにより、キーボードユーザーにはフォーカスリングが表示され、マウスユーザーには通常表示されません。ブラウザの未変更のフォーカスインジケーターを優先します。デザインでカスタムリングが必要な場合は、プロジェクトのフォーカストークンまたは別の明示的な色を使用し、インジケーター全体が交差するすべての隣接色に対して検証します。currentColor は、同じチェックを行った後でのみ許容されます。少なくとも 2px の実線の周囲、または同等の可視領域を使用してください。検証済みの代替なしに outline: none を使用したり、forced-colorsモードでシステムカラーを保持したりしないでください。

3. 完全なキーボードサポート

すべてのポインター操作には、ARIA APGパターンに従ったキーボードパスが必要です。Escapeでオーバーレイを閉じ、矢印キーで複合ウィジェット(タブ、メニュー、リストボックス)内を移動し、Tabでウィジェット間を移動し、EnterとSpaceでアクティブ化します。tabindex="0"(自然なタブ順序に参加)と tabindex="-1"(プログラムによるフォーカス)のみを使用し、自然な順序を壊す正の値は使用しないでください。複合ウィジェットはロービングtabindexを使用します。アクティブなアイテムは 0、それ以外はすべて -1 です。

4. フォーカスのトラップと復元

モーダルは背景コンテンツに inert を設定し、開くときに内部にフォーカスを移動し、閉じるときにトリガーにフォーカスを戻します。背景コンテンツがスクロールしないように overscroll-behavior: contain を追加します。

5. 最小ヒットエリア

WCAG 2.5.8のレベルAA基準は、24×24 CSSピクセルのターゲット、または定義された間隔、同等のコントロール、インライン、ユーザーエージェント、または必須の例外のいずれかです。より簡単なアクティブ化のために、タッチコンテキストでは44×44px、密度が許せばデスクトップインターフェースでは40×40pxを目指します。可視要素を小さく保つ必要がある場合は、疑似要素で拡張してください。拡張されたヒットエリアが重ならないように注意してください。

6. すべてのコントロールにラベルとタイプを設定

すべての入力には <label for> またはラッピング <label> を付けます。プレースホルダーはラベルではありません。ラベルとコントロールは1つのヒットターゲットを共有します。チェックボックスとそのテキストの間にデッドゾーンを作らないでください。意味のある name で autocomplete を追加し、キーボードに適した正しい type と inputmode を設定します。ペーストをブロックしないでください。ユーザーはパスワードとワンタイムコードをペーストします。

7. エラーを通知する

リクエストが開始されるまで送信を有効にしておき、その後スピナーで無効にしても元のラベルは保持します。送信時に検証します。失敗したフィールドに aria-invalid="true" を設定し、aria-describedby でインラインエラーテキストを指し、最初の無効なフィールドにフォーカスします。ネイティブコントロールが本当に使用できない場合にのみ、ネイティブの disabled を使用します。フォーカス可能性や発見可能性を意図的に保持する場合にのみ aria-disabled="true" を使用し、その場合はコードでポインター、キーボード、フォームの動作をブロックし、状態を明示的にスタイル設定します。

8. どこでもアクセシブルな名前

アイコンのみのボタンには、説明的な aria-label が必要です。可視のラベルテキストはアクセシブルな名前に含まれている必要があります。装飾的な要素には aria-hidden="true" を設定しますが、フォーカス可能な要素には決して設定しないでください。

9. 色だけに頼らない

ステータスには、色と一緒にアイコン、テキスト、または下線などの冗長な手がかりが必要です。コンテンツと状態に基づいて適用されるWCAGコントラスト要件を判断し、better-colors を使用してレンダリングされた前景/背景ペアを測定します。コントラストが失敗した場合は、ペアとそれが満たしていない要件を報告します。プロジェクトの色を尋ねられずに変更しないでください。

10. prefers-reduced-motionを尊重

モーションは @media (prefers-reduced-motion: no-preference) でラップし、オプトインにします。動きの抑制が設定されている場合、スライドやスケールを不透明度のクロスフェードに置き換え、パララックスや自動再生を完全に停止します。設定に関係なく、自動再生メディアには可視の一時停止コントロールが必要であり、アクションやエラーを含むトーストはユーザーが閉じるまで表示されたままにします。

11. 動的コンテンツを通知する

フィールド固有の検証には aria-describedby を使用し、コントロールに関連しない緊急でない更新(トーストや結果件数など)にはpoliteライブリージョン(role="status")を使用し、コントロールに関連しない緊急エラーには role="alert" のみを使用します。信頼性の高い繰り返しのpolite通知には、テキストを更新する前に安定した空のリージョンをレンダリングします。動的に挿入されるアラートはサポート状況が異なるため、ターゲットのスクリーンリーダーでテストする必要があります。

12. 目的に応じたaltテキスト

装飾的な画像には alt=""、情報を伝える画像は意味を説明し、機能的な画像はアクションを説明します。検索アイコンボタンは alt="Search" であり、alt="magnifying glass" ではありません。

13. 構造はナビゲーション

セクションを説明し、一貫したアウトラインを形成する見出しを使用します。1つのページレベルの <h1> と適切にネストされたレベルが推奨されるデフォルトであり、スタンドアロンのWCAG合否ルールではありません。1つの可視のプライマリ <main> ランドマークを公開します。繰り返しのナビゲーションやクロームがその前に配置されている場合は、「スキップしてコンテンツへ」リンクを最初のフォーカス可能な要素にします。アンカー付きの見出しには scroll-margin-top を設定します。

14. ズームとテキストサイズ変更に耐える

ページは200%ズームと320px幅でのリフローで水平スクロールなしで動作する必要があります。テキストコンテナには固定の height ではなく min-height を使用し、コードベースの慣習に合う場合は rem ブレークポイントを優先し、ビューポートのメタタグでユーザーのズーム範囲を制限しないでください。

よくある間違い

間違い修正
フォーカスリングを削除するために outline: none代わりに :focus-visible をスタイル設定。マウスクリックでは表示されません
カスタムフォーカス色がどこでも機能すると仮定すべての隣接色とforced-colorsモードでインジケーター全体を検証
ボタンまたはリンクに <div onClick>アクションには <button>、ナビゲーションには <a href>
プレースホルダーを唯一のラベルとして使用可視の <label for> を追加。プレースホルダーは入力時に消えます
フォーカス順序を修正するための正の tabindexDOMの順序を修正。0 と -1 のみを使用
繰り返されるpolite更新の通知が一貫しない安定した空のステータスリージョンを維持し、そのテキストを更新。ターゲットのスクリーンリーダーをテスト
ルーチンのトーストに対する assertive ライブリージョンpolite を使用。assertive はエラーのために予約
フォーカス可能な要素への aria-hidden="true"削除するか、要素をフォーカス不可にする
機能的なアイコンのaltが画像を説明アクションを説明:alt="Search"、alt="magnifying glass" ではない
フォームが有効になるまで送信を無効有効にしておき、送信時に検証して最初のエラーにフォーカス

レビュー出力形式

この形式は、ユーザーがスタンドアロンのアクセシビリティレビューを明示的に要求した場合にのみ使用します。better-interface がレビューを調整する場合は、ドメインのエビデンスと発見事項をそのスキルに提供し、そのスキルの出力形式、重大度スケール、統合ルール、上限、判定を優先させます。

スタンドアロンレビューは2つのパートで提示します。

発見事項

確認されたすべての発見事項を原則ごとにグループ化します。重大度、場所、修正前、修正後、理由 の列を持つマークダウンテーブルを使用します。「修正前:」/「修正後:」の別々の行は絶対に使用しないでください。

  • 重大度: HIGH はタスクを妨げる、支援技術からコンテンツを隠す、または体系的なアクセシビリティ障害を作り出す。MEDIUM は操作を著しく困難にする。LOW は孤立した洗練の問題。
  • 場所: path/to/file:line を引用。成果物にソースファイルがない場合は、代わりに正確な画面とコンポーネントを引用。
  • 修正前 / 修正後: 現在の実装と実行可能な代替案を示す。
  • 理由: 違反した原則とそのユーザーへの影響を挙げる。

繰り返される体系的な問題は1行に統合し、影響を受けるすべての場所をリストします。発見事項のない原則は省略します。

例

どこでもアクセシブルな名前

重大度場所修正前修正後理由
HIGHsrc/Dialog.tsx:42<button><XIcon /></button>aria-label="Close" を追加。アイコンを aria-hidden="true" に設定アイコンのみのコントロールにアクセシブルな名前がない
HIGHsrc/Nav.tsx:18<a href="/settings"><GearIcon /></a>aria-label="Settings" を追加リンク先がスクリーンリーダーで利用できない

可視のフォーカスリング

重大度場所修正前修正後理由
HIGHsrc/button.css:12button:focus { outline: none; }button:focus-visible { outline: 2px solid; outline-offset: 2px; }キーボードユーザーがフォーカスを見られない
HIGHsrc/Menu.tsx:31focus:outline-nonefocus-visible:outline-2 focus-visible:outline-offset-2メニューナビゲーションに可視のフォーカスインジケーターがない

エラーを通知する

重大度場所修正前修正後理由
HIGHsrc/EmailField.tsx:27エラーが border-red-500 だけで表示されるaria-invalid="true" + インラインエラーテキストを示す aria-describedby="email-error" を追加色だけではエラーを説明も通知もしない
MEDIUMsrc/SignupForm.tsx:64フォームが有効になるまで送信が無効送信を有効に保ち、失敗時に最初の無効なフィールドにフォーカス無効なアクションは何を修正すべきかを隠す

最小ヒットエリア

重大度場所修正前修正後理由
MEDIUMsrc/Toolbar.tsx:22size-4 アイコンのみのボタンafter:absolute after:size-11 でヒットエリアを44×44pxに拡張ターゲットが小さすぎてタッチ入力が信頼できない

検証と判定

発見事項の後:

  1. 検証: 実行した正確なチェックとその観察結果をリストします。キーボードトラバーサル、アクセシブル名の検査、適用可能な場合はスクリーンリーダーまたは自動チェックを含めます。チェックが実行されなかった場合は、まだ検証が必要なものを記載します。
  2. 判定: HIGH の発見事項が残っている場合は Block、MEDIUM または LOW の発見事項のみが残っている場合は Needs changes、実行可能な発見事項がまったく残っていない場合のみ Approve。

発見事項がない場合は、テーブルを省略し、「実行可能なアクセシビリティ発見事項はありません」と記載し、検証を報告し、Approve で終了します。

Individual skills in this repo

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

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

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.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

xzedm/clipplic-landing

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic. A promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

関連スキル