Medical Record Request Custodian Map
Check your requested file list and department contacts for missing supporting records.
Medical billing records
US$11View skill
Medical Underpayment Contract Arithmetic
Recheck the figures in your supplied fee schedule and paid lines against the rules you supply.
A downloadable skill for your AI agent.
Your result
Arithmetic differences for billing review.
Source references, missing information, and questions to review stay with the findings.
How to use it
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.
Provide your records
Supplied fee schedule and paid lines. Confirm the case and period you want to check.
Ask for the report
Copy the request below into your agent. Add the files and any task details it needs.
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 Medical Underpayment Contract Arithmetic skill. Review the attached records: supplied fee schedule and paid lines. Prepare this result: arithmetic differences for billing review. 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 records the rule and the values used in each calculation. It works out the expected amount and compares it with the reported amount.
What you provide
Supplied fee schedule and paid lines.
Details it records
- Supplied contracted rate
- Quantity
- Paid amount
Read the full task logic
For this task, keep one review row for each service line + fee rule. Record supplied contracted rate, quantity, and paid amount. Keep the source location beside each value.
Track the payer's exact request and response. Separate original claims, corrections, appeals, receipts, adjustments, and refunds.
Use supplied fee schedules and deadline sources. Do not generate medical justification or change clinical coding.
The helper validates arithmetic, not the legal or business rule. It does not infer a formula, evaluate spreadsheet functions, or round silently. Use a sourced tolerance for rounding comparisons.
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
| Sample record | expression: quantity * rate; variables: quantity: 4; rate: 25.00; observed: 101.00; unit: example units |
|---|
What comes back
A difference needs review
- The reported amount differs from the amount calculated with the supplied rule.
- Expected
- 100.00
- Recorded
- 101.00
- Difference
- 1.00
This result comes from the checking tool in your download.
Read the source records
These are synthetic records from the bundled example.
- rule · fixture rule
Synthetic rule: amount = quantity * rate; no tolerance. Not customer evidence. - source-r1 · records/r1
{"expression": "quantity * rate", "id": "r1", "key": "service line + fee rule / SYNTHETIC-001", "observed": "101.00", "rule_source_id": "rule", "unit": "synthetic-unit", "variables": {"quantity": "4", "rate": "25.00"}}
Checked values
- expected: 100.00; observed: 101.00; delta: 1.00; unit: synthetic-unit
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-resultExpected 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.
- A start guide to help you set up the skill.
- Task instructions that tell your AI what to check.
- Checking tools with worked examples.
- A report template with space for evidence and next actions.
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.
Collect the records
Start with supplied fee schedule and paid lines. Confirm the case, period, and source versions before the review.
Extract the task fields
Use claim ID, payer, service date, appeal version to keep records distinct. The agent records the original value, an exact quote, and the source location.
Recheck the calculation
Apply the supplied formula and compare the calculated amount with the reported amount. Run the Python helper on the structured records. Check each finding against its source.
Complete the report
Prepare the task result: arithmetic differences for billing review. 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.