Menu
Guidelines for writing accessibility test library entries including tests and subtests with proper descriptions and automation notes
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Determines which accessibility tests from the test library apply to a VA Design System component based on its features and implementation.
Creates and standardizes Mermaid decision flowcharts in VA Design System documentation, including templates, node types, accessibility alternatives, and the standard Jekyll include pattern.
Use when the user wants to merge all PRs they have approved - updates each branch from main, waits for CI checks to pass, merges, then summarizes results
Use when a designer or engineer asks questions about accessibility of their product, components, or processes.
Use when a designer asks to work on guidance or documentation issues, process documentation queue, or close out doc tickets - fetches oldest issue from quarterly epic and guides through resolution
Use after selecting a documentation issue from the doc-queue to groom it - analyzes the issue, identifies gaps, prompts the designer for clarity, and posts a structured grooming comment so the issue is ready for the writing-vads-guidance skill or an async agent
| name | writing-test-library-entries |
| description | Guidelines for writing accessibility test library entries including tests and subtests with proper descriptions and automation notes |
Use this skill when: Creating new test entries, editing existing test descriptions, or reviewing test library content for consistency.
Test library files:
src/_data/accessibility-tests/test-library/1-perceivable.ymlsrc/_data/accessibility-tests/test-library/2-operable.ymlsrc/_data/accessibility-tests/test-library/3-understandable.ymlsrc/_data/accessibility-tests/test-library/4-robust.ymlsrc/_data/accessibility-tests/test-library/_config.ymlAll guidelines for writing and editing test library entries live in:
src/_data/accessibility-tests/test-library/README.md
Read the following sections before creating or editing entries:
description_short, description_full, and automation_notes with good/bad examples
full and partial automation coverage; describe what can be automated and what requires manual testing