Short-Paid Freight Reason Decoder
Check whether the amounts in your remittance advice and invoice agree.
Freight billing
US$11View skill
Detention Free-Time Exclusion Sheet
Recheck the figures in your supplied contract exclusions and time logs against the rules you supply.
A downloadable skill for your AI agent.
Your result
Calculation with explicitly excluded periods.
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 contract exclusions and time logs. 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 Detention Free-Time Exclusion Sheet skill. Review the attached records: supplied contract exclusions and time logs. Prepare this result: calculation with explicitly excluded periods. 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 contract exclusions and time logs.
Details it records
- Arrival
- Release
- Free time
- Excluded duration
- Rate
Read the full task logic
For this task, keep one review row for each load + detention calculation. Record arrival, release, free time, excluded duration, and rate. Keep the source location beside each value.
Preserve the rate confirmation, appointment, arrival, release, and delivery evidence. Identify which carrier agreement and revision governs each charge.
Use explicit time zones, free-time rules, weights, units, currencies, and charge rates. A carrier claim is not proof of service.
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": "load + detention calculation / 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 contract exclusions and time logs. Confirm the case, period, and source versions before the review.
Extract the task fields
Use load, carrier, stop, charge type, invoice revision 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: calculation with explicitly excluded periods. 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.