Skip to main content

Install the Skill

The skill is the brain of every integration: it carries the invocation directive (so the agent reaches for the corpus on its own), the selection logic (decompose the request, pick patterns via Use When / Do Not Use When), and the retrieval step. There's one skill variant per retrieval method — they differ only in where the skill's retrieval step goes.

Skill variantRetrievalDownloadExtra setup
HTTP (recommended)fetches pattern pages from this siteZIP ↓none
Localreads a bundled copy from diskZIP ↓none
MCPcalls the MCP server's toolsZIP ↓install the MCP server
RAGqueries your vector DBZIP ↓index the corpus + fill config

The table links the Web / React downloads. Android / Compose ships the same four variants — see its section below. Stacks are not interchangeable: install the one for the UI you are writing.

HTTP and Local are self-contained — download, unzip, done. MCP and RAG add a retrieval mechanism the skill points at (a server, or your vector DB), so each has an extra setup step on its own page. All four are the same brain; only the retrieval step differs.

How to install​

Every variant installs the same way — unzip into your tool's skills directory. MCP and RAG then need their one extra retrieval-setup step (the server, or the config + indexing), linked in the table above.

Each download is a folder containing a SKILL.md plus any supporting files. The skill's canonical name (declared in its frontmatter) is also the folder name, so the install target is straightforward:

AI toolInstall location
Claude Code.claude/skills/
Cursor.cursor/skills/
GitHub Copilot (VSCode).github/skills/
Opencode.opencode/skills/
Codex.agents/skills/
BASH
unzip a11y-context-web-react-http.zip -d .claude/skills/

The unzipped skill sits in your tool's skills directory:

your-project/
├── .claude/
│   └── skills/
│       └── a11y-context-web-react-http/
│           └── SKILL.md
├── src/
└── package.json

For org-level distribution, point your internal skills registry (or a sanctioned fork) at the a11y-context-skills repository directly rather than redistributing the ZIP.

Web / React​

A11y Context — Web React (HTTP)​

Download a11y-context-web-react-http.zip · View source

The agent fetches patterns from this site at generation time. One file, no bundled corpus, always current.

  • Always current — pattern updates land on every consumer's next request; no manual refresh
  • Smallest footprint — a single SKILL.md file in your repo; the corpus lives on the docs site
  • 30–40% cheaper in retrieval-side tokens than alternative transports in controlled testing

Needs: network access from the agent (HTTP fetch to https://a11y-context-project.vercel.app).

A11y Context — Web React (Local)​

Download a11y-context-web-react-local.zip · View source

The agent reads patterns from a copy of the corpus bundled with the skill. Fully offline.

  • Works offline — no network dependency; survives air-gapped or network-restricted environments
  • Fastest retrieval — local disk reads, no HTTP latency
  • Pinned corpus version — reproducible builds and predictable agent behavior; ideal when an organization wants control over when pattern updates roll out

Needs: periodic refresh as the upstream corpus evolves. The bundled corpus carries a catalog_revision; check Release Notes and re-download to update.

A11y Context — Web React (MCP)​

Download a11y-context-web-react-mcp.zip · View source

The skill (the brain) whose retrieval step calls the MCP server's tools. The skill selects patterns; the server retrieves them.

Needs: the A11y Context MCP server configured in your MCP client. Install the skill and the server together.

A11y Context — Web React (RAG)​

Download a11y-context-web-react-rag.zip · View source

The skill plus an a11y-context.config.json scaffold. Fill in your vector-DB endpoint and index name, then the skill queries your retrieval system.

Needs: the A11y Context corpus indexed into your retrieval system, and the config filled in. See Custom / Enterprise RAG.

iOS / SwiftUI​

Beta — coming soon.

Android / Compose​

Same four variants, Compose patterns. The Golden Patterns are Kotlin, and the semantics are Android's — nothing in them translates to React or SwiftUI.

A11y Context — Android Compose (HTTP)​

Download a11y-context-android-compose-http.zip · View source

The agent fetches patterns from this site at generation time. One SKILL.md plus the catalog, always current.

Needs: network access from the agent.

A11y Context — Android Compose (Local)​

Download a11y-context-android-compose-local.zip · View source

The agent reads patterns from a copy of the corpus bundled with the skill. Fully offline, pinned to a catalog_revision.

Needs: periodic refresh. Check Release Notes and re-download to update.

A11y Context — Android Compose (MCP)​

Download a11y-context-android-compose-mcp.zip · View source

The brain, retrieving through the MCP server's tools with stack: "android/compose".

Needs: the A11y Context MCP server configured in your MCP client, at a release that bundles the Android catalog.

A11y Context — Android Compose (RAG)​

Download a11y-context-android-compose-rag.zip · View source

The skill plus an a11y-context.config.json scaffold already set to the android/compose stack.

Needs: the corpus indexed into your retrieval system, and the config filled in. See Custom / Enterprise RAG.

Other consumption paths​

  • Browse the corpus directly: Web / React patterns. Useful for QA testing, manual reference, and custom integrations.
  • Clone the skills repo: git clone https://github.com/a11y-context/a11y-context-skills — and copy any skill folder into your AI tool's skills directory.

Verifying installation​

See Verify it's working for the test prompts and pass criteria.

On This Page