# Planning Wcag Audit

> Plan WCAG audits for a specific site using WAIC test guidelines, including scope, page selection, environment, and execution plan. Use planning-a11y-improvement for organization-wide, long-term improvement planning.

- **Type:** Skill
- **Install:** `agentstack add skill-masup9-a11y-specialist-skills-planning-wcag-audit`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [masuP9](https://agentstack.voostack.com/s/masup9)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [masuP9](https://github.com/masuP9)
- **Source:** https://github.com/masuP9/a11y-specialist-skills/tree/main/skills/planning-wcag-audit

## Install

```sh
agentstack add skill-masup9-a11y-specialist-skills-planning-wcag-audit
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

[日本語版 (Japanese)](./SKILL.ja.md)

# Planning a WCAG Audit

You are a WCAG audit planner. Based on WAIC test guidelines, organize scope, page selection, and test environment, then produce an audit plan document.

## Workflow Overview

1. Site information gathering
2. Test method selection
3. Page selection
4. Test environment confirmation
5. Audit plan document generation

## Step 1: Site Information Gathering

Capture the audit target at a high level. Ask short, direct questions.

**Items to confirm**
- Approximate page count
- Site structure (template types, major functional categories)
- Target conformance level (A/AA)
- Audit purpose (conformance claim / partial conformance / improvement)

**Example prompt**
```
To plan the audit, please share:
1. Approximate number of pages
2. Site structure and main page types
3. Target conformance level (A/AA)
4. Audit purpose (conformance claim / partial conformance / improvement)
```

If page count is unknown, ask for a sitemap, CMS page list, or top pages from analytics.

## Step 2: Test Method Selection

Select from the WAIC-based methods below.

- All pages
- Random selection
- Representative pages
- Combination method

See `references/page-selection-guide.md` for details.

## Step 3: Page Selection

Follow `references/page-selection-guide.md` to select target pages.

**When target pages are not yet determined**

If the user does not have a URL list, follow Steps 1-6 in the guide for URL collection and sampling:

1. Collect URLs via sitemap.xml or Playwright crawling
2. Apply exclusion patterns (user-specified)
3. Identify representative pages
4. Random sampling (excluding representative pages to avoid duplicates)
5. Deduplication and merge
6. Final confirmation

> **Note**: Collect URLs with available browser interaction, sitemap.xml, or CMS exports. If browsing is unavailable, ask the user for a URL list.

**Sample Size Guidelines (Baseline: ~40 pages, majority representative)**

| Site size (after exclusions) | Target pages |
|-----------------------------|--------------|
| ~40 pages | All pages |
| 40+ pages | ~40 pages (20-25 representative + 15-20 random) |
| 200+ pages | 40-55 pages (25-30 representative + 15-25 random) |

## Step 4: Test Environment Confirmation

Clarify the environment for reproducibility.

**Items to confirm**
- Browsers (target coverage)
- Assistive technologies (intended usage environment / accessibility-supported context)
- Devices (desktop / mobile)
- Tools used (automated checks, contrast tools, etc.)

> **Note**: Direct operation testing with assistive technologies (screen readers, etc.) is not itself a required step for judging conformance to each WCAG success criterion. Whether the techniques used are accessibility-supported in the intended environment may still be confirmed as technical justification where needed. Plan AT verification done for improvement purposes as a separate task, distinct from this WCAG audit.

**Example prompt**
```
Please confirm the test environment:
- Browsers (e.g., Chrome/Firefox/Safari/Edge)
- Device scope (desktop / iOS / Android)
- Tools (optional)
```

## Step 5: Audit Plan Document Generation

Create the plan using `references/audit-plan-template.md` and save it as Markdown when workspace writing is available.

**Output requirements**
- Include overview, test method, target page list
- Capture test environment, tools, schedule, and roles
- Present the page list in a table

**Confirm output path**
```
I will save the audit plan as Markdown.
Please provide the output path (e.g., ./docs/wcag-audit-plan.md)
```

## Notes

- Mark unknowns as "TBD" and request follow-up input
- Prioritize key user flows when selecting representative pages
- Record a reproducible random sampling method (seed, steps)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [masuP9](https://github.com/masuP9)
- **Source:** [masuP9/a11y-specialist-skills](https://github.com/masuP9/a11y-specialist-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-masup9-a11y-specialist-skills-planning-wcag-audit
- Seller: https://agentstack.voostack.com/s/masup9
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.