Skip to content

Add wcag-accessibility-widget skill#20

Open
Tura2 wants to merge 2 commits into
skills-il:masterfrom
Tura2:add-wcag-accessibility-widget
Open

Add wcag-accessibility-widget skill#20
Tura2 wants to merge 2 commits into
skills-il:masterfrom
Tura2:add-wcag-accessibility-widget

Conversation

@Tura2

@Tura2 Tura2 commented Apr 16, 2026

Copy link
Copy Markdown

Summary

  • Self-hosted floating accessibility widget for Israeli websites (WCAG 2.1 AA / ת"י 5568)
  • Covers high contrast, font size, keyboard nav, readable font, heading/link markers — no third-party service
  • Includes Hebrew (SKILL_HE.md) and English (SKILL.md) versions, metadata.json, and references
  • Documents the required הצהרת נגישות (accessibility declaration) page with a ready-to-use Next.js template
  • Documents the position:fixed + CSS filter stacking context bug and safe workarounds

סיכום

  • ווידג'ט נגישות עצמאי לאתרי אינטרנט ישראליים (WCAG 2.1 AA / ת"י 5568)
  • מכסה ניגודיות גבוהה, גודל גופן, ניווט מקלדת, גופן קריא, סימון כותרות וקישורים — ללא שירות צד שלישי
  • כולל גרסה בעברית (SKILL_HE.md) ובאנגלית (SKILL.md), קובץ metadata.json והפניות
  • כולל תבנית מוכנה לשימוש לדף הצהרת נגישות ב-Next.js
  • מתעד את באג position:fixed + filter ב-CSS עם פתרונות בטוחים

File Map

wcag-accessibility-widget/
├── SKILL.md              # English skill file
│                         #   - WCAG 2.1 AA checklist (skip link, alt text, contrast, ARIA, etc.)
│                         #   - Widget architecture: Settings type, CSS class map, localStorage persist
│                         #   - Toggle switch implementation (RTL-safe with translateX)
│                         #   - CSS modes: high contrast, no animations, font scale, readable font,
│                         #               mark headings, mark links
│                         #   - Critical bug: CSS filter breaks position:fixed — root cause + fix
│                         #   - Widget placement in layout.tsx (z-index guide)
│                         #   - Accessibility declaration page (Israeli law requirements)
│                         #   - Common mistakes table
│
├── SKILL_HE.md           # Hebrew translation (עברית) — full mirror of SKILL.md
│                         #   - כולל את כל הסעיפים בעברית
│                         #   - תבנית מוכנה לדף הצהרת נגישות (Next.js TSX)
│
├── metadata.json         # Skill metadata
│                         #   - Bilingual display name + description (he/en)
│                         #   - Tags in Hebrew and English
│                         #   - Supported agents: claude-code, cursor, github-copilot,
│                         #     windsurf, opencode, codex, antigravity, gemini-cli
│
└── references/
    └── README.md         # External references and links
                          #   - Israeli law: חוק שוויון זכויות, תקנות נגישות, ת"י 5568
                          #   - נציבות שוויון זכויות contact
                          #   - WCAG 2.1 spec + quick reference
                          #   - Testing tools: axe, WAVE, Colour Contrast Analyser, NVDA
                          #   - MDN reference for CSS stacking context (filter bug)

Self-hosted floating accessibility widget for Israeli websites.
Covers WCAG 2.1 AA / ת"י 5568 compliance, CSS class architecture,
RTL-safe toggles, position:fixed filter bug, and הצהרת נגישות page template.
@github-actions

Copy link
Copy Markdown

Welcome to Skills IL! Thanks for your first contribution.

Our automated checks are running now:

  • Skill Validation - Checking your SKILL.md format
  • Security Scan - Scanning for secrets and vulnerabilities

While you wait, make sure you've reviewed our Contributing Guide.

A maintainer will review your PR within 48 hours.

@choroshin

choroshin commented May 16, 2026

Copy link
Copy Markdown
Contributor

Heads-up from skills-il maintainers: a new CI step landed in this repo on 2026-05-17 that requires every touched skill folder to include evidence.json, a structured list of every factual claim in the skill paired with the official source URL it came from. See /he/guides/how-we-validate for the full rationale.

This PR will currently fail the Skill Validation check. Two paths forward:

  1. You add evidence.json to your skill folder. Schema: a JSON array of { "claim": "...", "source_url": "https://..." } objects, one entry per concrete fact (form number, fee amount, deadline, statute reference, percentage, etc.). Every claim must be sourced to an official URL.
  2. We backfill it for you when we next triage submissions. Reply on this PR if you'd prefer that route.

Either way, we won't silently merge skills missing the evidence file. It would undermine the public promise the guide makes. Sorry for the disruption mid-PR.

Required by new CI validation step (added 2026-05-17) that enforces evidence.json in every touched skill folder.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants