Screen Reader Announcement Revision Diff

Find where your approved transcripts and retest transcripts disagree.

A downloadable skill for your AI agent.

Your result

Changed spoken output.

Source references, missing information, and questions to review stay with the findings.

How to use it

  1. Add the skill to your AI

    Open your download and follow the start guide. Use an AI agent that can load skill files and run the included tools.

  2. Provide your records

    Approved transcripts and retest transcripts. Confirm the case and period you want to check.

  3. Ask for the report

    Copy the request below into your agent. Add the files and any task details it needs.

  4. Review and save

    Check the findings against the original records. Choose where to save the report and follow up on open questions.

Example request

Use the Screen Reader Announcement Revision Diff skill. Review the attached records: approved transcripts and retest transcripts. Prepare this result: changed spoken output. Include a source reference for each finding. List missing information and questions that need my review. Ask me to confirm the scope and where to save the report before you start.

What it checks

It puts records for the same item side by side. It keeps both original values when they differ, so you can check the source.

What you provide

Approved transcripts and retest transcripts.

Details it records

  • Action
  • Exact spoken text
  • Reader version
  • Cut revision
Read the full task logic

For this task, keep one review row for each control + announcement sequence. Record action, exact spoken text, reader version, and cut revision. Keep the source location beside each value.

Link findings to reproducible locations and test evidence. Preserve assistive technology, browser, platform, and criterion versions.

Capture comparable screen-reader announcements for the same route, control, action, browser, and reader version. Preserve exact spoken text and order. Compare the extracted arrays, then explain changes in context. The helper does not operate or emulate a screen reader.

A closed ticket does not prove remediation. Report exact retest evidence and untested states; do not claim full accessibility from a subset.

A changed value does not show which source is correct. Semantic equivalence and identity aliases need an explicit mapping and review.

Example result

This synthetic example shows the included check in use. Your agent uses its findings to complete your task report.

What you provide

Synthetic example records

Synthetic inputs for Screen Reader Announcement Revision Diff
Starting recordaction: source-A
Record to checkaction: source-B

What comes back

A difference needs review

  • The two records give different values for the same item.

This result comes from the checking tool in your download.

Read the source records

These are synthetic records from the bundled example.

  • source-e1 · expected/e1
    {"id": "e1", "key": "control + announcement sequence / SYNTHETIC-001", "value": {"action": "source-A"}}
  • source-o1 · observed/o1
    {"id": "o1", "key": "control + announcement sequence / SYNTHETIC-001", "value": {"action": "source-B"}}

Checked values

  • expected: action: source-A; observed: action: source-B
Run this example

After purchase, extract the ZIP. Run these commands from the skill folder. Use a new output folder.

python3 scripts/checks.py
python3 scripts/audit.py assets/example.json \
  --files-root assets/sample-files --output-dir example-result

Expected exit code: 1. Code 0 means no helper finding. Code 1 means a finding or review item. Code 2 means incomplete or invalid input.

The check uses the records you supply. Review each finding against the original documents.

What is saved

Ask your agent to save the completed task report in a folder you choose. The report template includes the result, source references, missing information, and next actions.

A readable check report
The local checking tool can save its findings as report.md.
A data copy
The same check can be saved as report.json for use in other tools. A local audit database is optional.

Tonotes does not receive your work documents through this website. Documents you share with an AI service follow that service's storage settings.

Your download

US$11 includes one skill in a ZIP with 18 files. You receive the instructions and tools to run the task with your own records.

Setup and file details

Use an agent that supports SKILL.md instructions and Python 3.10 or later with SQLite. Your AI-agent service is separate.

Start guide: 1 file
START-HERE.md explains setup and the expected example result.
Agent instructions: 1 file
SKILL.md defines this task and its completion checks.
Task references: 4 files
The task guide, input contract, tools guide, and research notes.
Python tools: 4 files
Check records, convert CSV input, and run the local checks.
Examples and templates: 8 files
The input schema, synthetic cases, expected report, and report template.
  1. Collect the records

    Start with approved transcripts and retest transcripts. Confirm the case, period, and source versions before the review.

  2. Extract the task fields

    Use finding, component, route or state, test environment, criterion version to keep records distinct. The agent records the original value, an exact quote, and the source location.

  3. Compare source values

    Match each item, then compare its supplied values. Run the Python helper on the structured records. Check each finding against its source.

  4. Complete the report

    Prepare the task result: changed spoken output. Include missing evidence, unresolved questions, and the next action for each open item.

Eight synthetic cases check the tool locally. Live-agent accuracy on real documents has not been tested.