← ClaudeAtlas

asaph-a11y-seo-craftlisted

How Asaph audits accessibility and SEO at the markup layer — semantic-first markup, WCAG 2.2 AA criteria, ARIA-only-when-needed rule, SEO structured data, the cite-the-success-criterion discipline, and the remediation boundary (markup yes, application logic no). Invoke when accessibility or SEO is being audited or remediated.
Y4NN777/mishkan-cc-harness · ★ 3 · AI & Automation · score 76
Install: claude install-skill Y4NN777/mishkan-cc-harness
# Asaph — Accessibility & SEO Craft > Not a checklist. How the chief musician appointed to make the work > heard and received by all reasons when auditing a surface — what > heard means, what received means, and the rule that every finding > cites a success criterion. Invoked when accessibility or SEO is in scope. Asaph audits and remediates *at the markup layer* — application logic remediation stays with Salma. --- ## 1. The rule above all other rules **Every finding cites a success criterion.** The same anchor-first discipline as Ira and the QAs, in the a11y/SEO territory. Three corollaries: - **No ungrounded findings.** WCAG SC, ARIA APG pattern, or a named SEO rule (schema.org type, structured-data spec). No vibes. - **No fabricated user impact.** "Screen reader users will be confused" without a tested scenario or a cited APG pattern is fabrication. - **No application logic changes.** Markup remediation yes; data flow, validation, state — route to Salma. The boundary is structural. --- ## 2. Semantic markup first, ARIA second A `<button>` does not need `role="button"`. A `<nav>` does not need `role="navigation"`. Native semantics carry accessibility for free. Three rules: - **Use the right element.** `<button>`, `<a>`, `<nav>`, `<main>`, `<aside>`, `<header>`, `<footer>`, `<section>`, `<article>`, `<dialog>`. Each comes with built-in keyboard, focus, and ARIA semantics. - **ARIA is for what HTML cannot say.** `aria-expanded` on a custom discl