# accesslint/skills architecture

> Architecture diagram of the GitHub repository accesslint/skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/accesslint/skills
- Repository: https://github.com/accesslint/skills

## Overview

AccessLint Skills is a set of agent-guided accessibility workflows, not an in-repository scanning engine. Users invoke scan and inspect for page-level findings, audit for site-wide WCAG-EM conformance, fix to edit and verify, and diff to check regressions. The graph reflects the README’s documented workflow and integrations; no source excerpts were provided, so implementation-level calls and internal MCP behavior are not inferred.

Main entry points: [`plugins/accesslint/skills/accessibility-audit/SKILL.md`](https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-audit/SKILL.md) (Site audit), [`plugins/accesslint/skills/accessibility-scan/SKILL.md`](https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-scan/SKILL.md) (Page scan), [`plugins/accesslint/skills/accessibility-inspect/SKILL.md`](https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-inspect/SKILL.md) (Manual inspect), [`plugins/accesslint/skills/accessibility-diff/SKILL.md`](https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-diff/SKILL.md) (Regression diff)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skills["Accessibility skills"]
  node_scan["Page scan<br/>[SKILL.md]"]
  node_inspect["Manual inspect<br/>[SKILL.md]"]
  node_audit["Site audit<br/>[SKILL.md]"]
  node_fix["Remediate<br/>[SKILL.md]"]
  node_diff["Regression diff<br/>[SKILL.md]"]
end

subgraph group_method["Shared methodology"]
  node_methodology["Audit methodology<br/>[methodology.md]"]
  node_checkpoints["Inspect checkpoints<br/>[checkpoints.md]"]
end

subgraph group_integrations["External integrations"]
  node_cli["AccessLint CLI"]
  node_mcp["AccessLint MCP"]
  node_browser["Browser MCP"]
  node_chrome["Chrome via CDP"]
  node_target["Web page"]
  node_hosted["Hosted connector"]
end

node_user(("Agent user"))

node_user -->|"invokes"| node_scan
node_user -->|"invokes"| node_inspect
node_user -->|"invokes"| node_audit
node_user -->|"invokes"| node_fix
node_user -->|"invokes"| node_diff
node_scan -->|"runs rules"| node_cli
node_diff -->|"uses"| node_cli
node_scan -->|"scans live DOM"| node_target
node_diff -->|"compares page"| node_target
node_audit -->|"runs per page"| node_scan
node_audit -->|"runs per page"| node_inspect
node_audit -->|"follows"| node_methodology
node_inspect -->|"uses"| node_checkpoints
node_audit -.->|"gets rule metadata"| node_mcp
node_inspect -.->|"gets rule metadata"| node_mcp
node_fix -->|"runs baseline and verify"| node_mcp
node_inspect -->|"drives page"| node_browser
node_browser -->|"controls"| node_target
node_chrome -->|"exposes CDP"| node_target
node_scan -->|"connects over CDP"| node_chrome
node_diff -->|"connects over CDP"| node_chrome
node_audit -->|"hands off findings"| node_fix
node_fix -->|"guards regressions"| node_diff
node_user -.->|"connects separately"| node_hosted

click node_scan "https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-scan/SKILL.md"
click node_inspect "https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-inspect/SKILL.md"
click node_audit "https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-audit/SKILL.md"
click node_fix "https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-fix/SKILL.md"
click node_diff "https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-diff/SKILL.md"
click node_methodology "https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/shared/methodology.md"
click node_checkpoints "https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-inspect/references/checkpoints.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_scan,node_inspect,node_audit,node_fix,node_diff,node_user toneBlue
class node_methodology,node_checkpoints toneAmber
class node_cli,node_mcp,node_browser,node_chrome,node_target,node_hosted toneMint
```

## Components

### Accessibility skills

- [Page scan](https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-scan/SKILL.md): `plugins/accesslint/skills/accessibility-scan/SKILL.md`
- [Manual inspect](https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-inspect/SKILL.md): `plugins/accesslint/skills/accessibility-inspect/SKILL.md`
- [Site audit](https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-audit/SKILL.md): `plugins/accesslint/skills/accessibility-audit/SKILL.md`
- [Remediate](https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-fix/SKILL.md): `plugins/accesslint/skills/accessibility-fix/SKILL.md`
- [Regression diff](https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-diff/SKILL.md): `plugins/accesslint/skills/accessibility-diff/SKILL.md`

### Shared methodology

- [Audit methodology](https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/shared/methodology.md): `plugins/accesslint/skills/shared/methodology.md`
- [Inspect checkpoints](https://github.com/accesslint/skills/blob/main/plugins/accesslint/skills/accessibility-inspect/references/checkpoints.md): `plugins/accesslint/skills/accessibility-inspect/references/checkpoints.md`

### External integrations

- **AccessLint CLI**
- **AccessLint MCP**
- **Browser MCP**
- **Chrome via CDP**
- **Web page**
- **Hosted connector**

### Other components

- **Agent user**

## Connections

- Agent user → Page scan: invokes (evidence: `README.md`)
- Agent user → Manual inspect: invokes (evidence: `README.md`)
- Agent user → Site audit: invokes (evidence: `README.md`)
- Agent user → Remediate: invokes (evidence: `README.md`)
- Agent user → Regression diff: invokes (evidence: `README.md`)
- Page scan → AccessLint CLI: runs rules (evidence: `README.md`)
- Regression diff → AccessLint CLI: uses (evidence: `README.md`)
- Page scan → Web page: scans live DOM (evidence: `README.md`)
- Regression diff → Web page: compares page (evidence: `README.md`)
- Site audit → Page scan: runs per page (evidence: `README.md`)
- Site audit → Manual inspect: runs per page (evidence: `README.md`)
- Site audit → Audit methodology: follows (evidence: `README.md`)
- Manual inspect → Inspect checkpoints: uses (evidence: `README.md`)
- Site audit → AccessLint MCP: gets rule metadata (evidence: `README.md`)
- Manual inspect → AccessLint MCP: gets rule metadata (evidence: `README.md`)
- Remediate → AccessLint MCP: runs baseline and verify (evidence: `README.md`)
- Manual inspect → Browser MCP: drives page (evidence: `README.md`)
- Browser MCP → Web page: controls (evidence: `README.md`)
- Chrome via CDP → Web page: exposes CDP (evidence: `README.md`)
- Page scan → Chrome via CDP: connects over CDP (evidence: `README.md`)
- Regression diff → Chrome via CDP: connects over CDP (evidence: `README.md`)
- Site audit → Remediate: hands off findings (evidence: `README.md`)
- Remediate → Regression diff: guards regressions (evidence: `README.md`)
- Agent user → Hosted connector: connects separately (evidence: `README.md`)
