Inspiration

Every household has a "Scans" folder: bills, insurance letters and receipts dumped in one place and never sorted. People miss payment dates and contract renewals, and still can't answer "how much did we pay for electricity this year?". Cloud apps can do this, but only if you upload your most private financial documents. A NAS already holds those files at home, so the sorting should happen there too.

What it does

Say "Sort my Scans folder" and Home Archivist:

  1. Finds every document and phone photo in the inbox.
  2. Reads them on the NAS: document type, sender, amount, due date, renewal date (OCR for photos of paper letters).
  3. Shows a filing plan: year/category/sender folders and tags like to-pay or renewal.
  4. Files and tags only after you approve. It never overwrites or deletes anything.
  5. Saves a "My deadlines" note: everything due, sorted by date, each with its source file.
  6. Answers questions like "what do I owe this month?" with file references.

Unreadable files go to Needs review. It never guesses values.

How I built it

An orchestration Skill that follows the Uliya Skill standard. The parent Skill only delegates self-contained tasks to the NAS experts with delegate --target:

  • ug-filesystem and ug-filemgr → file-agent: find files, create folders, move files, tag files;
  • ug-document → document-agent: extraction, optional translation, Q&A;
  • ug-photo → photo-agent: OCR;
  • ug-knowledge → knowledge-agent: saves the deadline note.

Every write passes the platform approval gateway. All five states (completed, failed, cancelled, waiting_user, waiting_approval) and empty results are handled. The package passes the official Uliya static checker with zero errors and zero warnings.

Challenges

  • Keeping it honest: the plan is built only from real extracted fields, and failed files are excluded rather than guessed.
  • There is no calendar capability, so deadlines become a NAS note instead of reminders.

What I learned

Good automation is mostly about saying "no": no guessing, no silent writes, no data leaving the device.

What's next

  • Validate on a real NAS with mixed scans and photos.
  • Recurring-bill summaries per year.
  • Reminders once a calendar capability is published.

Built With

  • markdown
  • ug-document
  • ug-filemgr
  • ug-filesystem
  • ug-knowledge
  • ug-photo
  • ugreen-ai-nas
  • uliya-skill-kit
Share this project:

Updates

Submission history