Live Region Controller

What it does

When your agent uses it

• Tasks that involve Accessibility

Example prompts

• “/live-region-controller”

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

1. 1Does every dynamic content update have a corresponding live region or focus management?
2. 2Are live regions in the DOM before their content changes?
3. 3Is aria-live="assertive" used only for genuine critical alerts?
4. 4Are rapid updates debounced?
5. 5Are loading states announced for operations over 2 seconds?
6. 6Are announcements short and meaningful?
7. 7Are live regions not hidden with display: none or visibility: hidden?
8. 8Is textContent used to update (not innerHTML or element replacement)?
9. 9For React: are live regions unconditionally rendered?
10. 10Are toasts announced without stealing focus?
11. 11Is aria-atomic set correctly (true for status messages, false/default for logs)?
12. 12Is aria-busy used to suppress intermediate announcements during batch updates?

What it can do on your machine

Read from SKILL.md and the folder at commit decf6ba. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Live Region Controller loads about 1.3k tokens when it runs, and up to ~3.5k if it reads all its reference files. Until then it costs about 25 tokens; SKILL.md has 559 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~25

When it runs · the whole SKILL.md, loaded when a task matches

~1.3k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~3.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Community-Access/accessibility-agents at commit decf6ba, republished under its MIT licence (© Community-Access). 559 words, ~1,339 tokens.

name

live-region-controller

description

Announce dynamic updates: live regions, toasts, loading states and results.

license

MIT

disable-model-invocation

true

metadata.tier

specialist

metadata.domain

web

metadata.output

findings

metadata.effort

medium

metadata.title

Live Region Controller

// GOOD: Region always in DOM, content changes via state
const [status, setStatus] = useState('');
return <div aria-live="polite">{status}</div>;

// BAD: Conditionally rendering the live region
{status && <div aria-live="polite">{status}</div>}

### [severity]: [Brief description]
- **WCAG:** [criterion number] [criterion name] (Level [A/AA/AAA])
- **Confidence:** [high | medium | low]
- **Impact:** [What a real user with a disability would experience - one sentence]
- **Location:** [file path:line or CSS selector or component name]

**Current code:**
[code block showing the problem]

**Recommended fix:**
[code block showing the corrected code in the detected framework syntax]

## Live Region Controller Findings Summary
- **Issues found:** [count]
- **Critical:** [count] | **Serious:** [count] | **Moderate:** [count] | **Minor:** [count]
- **High confidence:** [count] | **Medium:** [count] | **Low:** [count]

© Community-Access, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/live-region-controller of Community-Access/accessibility-agents.

• SKILL.md
• agents/openai.yaml
• examples/findings.json
• references/politeness-levels.md

Open the folder on GitHubat commit decf6ba