Inspiration
Households keep insurance, tax, lease and contract files on a NAS. When an AI answers a question about them without a source, nobody can check the number, and one wrong premium or deadline costs real money. People end up reopening every file anyway.
What it does
Receipt Desk answers a question about the documents in one folder the user picks, and attaches a receipt to every fact: the real file path and the cited passage. There are three outcomes per question.
- Answered - the fact with its receipt.
- Not found - the searched folder is named and nothing is invented.
- Conflict - the answer is withheld and the disagreeing passages are shown side by side.
A coverage block lists which files were read fully, sampled, or could not be read. The Skill is read-only; saving the receipt sheet happens only after approval.
How we built it
The Skill follows the Uliya Skill Development Standard and was written and checked with the official UGOS Skill Creation Tool. SKILL.md orchestrates three delegations in order: file-agent (ug-filesystem: find, stat) lists candidate documents, document-agent (ug-document: qa, metadata) answers only from those files with citations and coverage, and knowledge-agent (ug-knowledge: save-text) saves the result on request under workflow approval. Each step passes only verified paths or passages forward.
Challenges we ran into
Deciding what the Skill must refuse to do. A missing citation is treated as no answer, and a disagreement between documents is a result to show, not to resolve.
Accomplishments that we're proud of
The package passes the official static checker with 0 errors and 0 warnings against catalog 2.2.0.
What we learned
Handling empty results, partial results and all five delegation states explicitly takes more of the SKILL.md than the happy path does.
What's next for Receipt Desk
It has not run on a NAS yet. If selected as a Finalist, we will validate citation granularity, conflict detection and coverage on scanned documents on the assigned UGREEN AI NAS.
Built With
- markdown
- ugos
- uliya-skill