Inspiration
Every photographer knows the problem: thousands of photographs scattered across SD cards, external drives, computers, and backup folders. Importing new media becomes a chore. Files get duplicated, folder structures become inconsistent, and important memories become harder to find.
A NAS provides a central place to store everything, but storage alone doesn't solve the problem of keeping a library organized.
What if your NAS could learn how you organize your media and help maintain that structure every time you import something new?
That's the idea behind Library Guard.
What it does
Library Guard is an AI-powered media ingestion and organization Skill for UGREEN AI NAS.
Its promise is simple: Organize once. Import with confidence.
Rather than imposing a fixed folder structure, Library Guard begins with a short onboarding interview to understand the user's preferences.
It helps establish a personalized library blueprint for photographs, videos, originals, edits, and shared media.
When the user places new files into a designated inbox, Library Guard coordinates NAS capabilities to:
- Inspect incoming files and available metadata.
- Identify exact duplicates and potential conflicts.
- Propose destinations based on the saved library structure.
- Separate uncertain files for manual review.
- Present a dry-run plan before making changes.
- Execute approved file operations.
- Generate an import report describing what happened.
The original library is protected from automatic deletion, and uncertain files are retained rather than silently discarded.
How we built it
Library Guard is designed as a Markdown-based AI Skill using UGREEN Uliya Skill Kit v0.7.7.
It orchestrates existing NAS capabilities through specialized agents:
- file-agent: File inspection, directory management, duplicate scanning, and organization workflows.
- photo-agent: Photo metadata, timeline information, and optional album creation.
- knowledge-agent: Persistent library blueprints and import reports.
The Skill separates planning from execution and requires user approval before modifying files.
Its initial package includes the Skill instructions, folder-blueprint guidance, and setup, removal, and testing documentation.
The package has passed the supplied static validation checker. Actual execution on UGREEN NAS hardware remains to be tested.
Challenges
The biggest challenge is ensuring that automation never compromises valuable media.
Duplicate filenames don't necessarily mean duplicate photographs. RAW and JPEG files may represent different versions of the same capture, and identical timestamps don't guarantee identical content.
Library Guard therefore distinguishes verified duplicates from uncertain matches and preserves files requiring review.
Another challenge is that the toolkit's general organization planner does not guarantee EXIF-based filing. The Skill must verify capture-date metadata and use supported file operations to establish the correct destinations.
Interrupted imports, filesystem permissions, and performance on large libraries are also important validation targets.
What we're proud of
Library Guard focuses on a problem that happens repeatedly, rather than a one-time AI interaction.
Its strongest design principles are:
- Personalization: The library structure reflects the user's preferences.
- Safety: Review before execution and protect original files.
- Repeatability: Use the same blueprint for future imports.
- Transparency: Explain what was filed, skipped, or flagged.
- Privacy: No external AI service or cloud upload is required by the Skill design.
What's next
Our next milestone is testing the Skill on an actual UGREEN AI NAS.
We plan to validate mixed-media imports, duplicate handling, RAW/JPEG preservation, missing capture dates, repeated imports, and recovery after interrupted operations.
Future enhancements could include richer event suggestions, optional album curation, and more advanced library-health analysis.
Our vision is to make the NAS more than a storage destination: an intelligent archivist that helps protect and maintain your digital memories.
Built With
- ai-agents
- duplicate-detection
- file-management
- markdown
- media-organization
- photo-management
- skill.md
- ugos
- ugreen-ai-nas
- uliya-skill-kit
- workflow-automation
