Inspiration
Millions of households own a private cloud - UGREEN's NASync NAS running UGOS Pro - yet the data inside stays trapped behind dashboards and manual backup buttons. Meanwhile, AI agents have become the primary interface people use to get things done, but they have no way to reach the machine that holds a family's most valuable files. The result: a private cloud that stores, but doesn't act.
What it does
AgentHome is an open-source agent skill package (SKILL.md + tooling) that lets any AI agent - Kiro, Claude, Cursor, or an OpenAI-compatible runtime - safely operate a UGREEN NAS through the UGOS Pro API. Ask in plain language: "Back up my laptop's photo library every night, keep three versions, alert me on failure" - the agent reads the skill, plans, calls the NAS, and reports back.
It covers four domains:
- Files & backup - browse, copy, dedupe, schedule versioned backups, restore in one sentence.
- Photos - dedupe near-identical shots, group by event, build monthly highlight folders.
- Health & ops - watch disk SMART, storage growth, share permissions; alert before failure.
- Home automation glue - expose NAS events to other agent workflows.
How we built it
Spec-first with Kiro: the SKILL.md defines a strict permission manifest (read-only by default; writes require confirmation; destructive actions go to a 7-day recycle window; scoped API tokens stay on-device; LAN-only), connector command surface (connector/ugos.py), worked examples, error handling and an audit log contract. Because the skill is standard markdown + HTTP calls, it plugs into any agent runtime that loads markdown skills.
Challenges we ran into
Designing permissions that are safe by default but not annoying: every destructive path needed a recoverable alternative (recycle window), and every scheduled action needed an audit trail. Iterating on the skill format until both humans and agents could parse it cleanly was the core loop of this hackathon.
Accomplishments that we're proud of
A complete, installable SKILL.md spec that a UGREEN NASync owner could use today, plus a clear Phase 2/3 roadmap (working UGOS Pro connector, photo curation, home-automation event bridge).
What we learned
Agent skills are contracts, not prompts. The permission manifest, audit log, and dry-run-first conventions matter more than clever command coverage.
What's next for AgentHome
Phase 2: working UGOS Pro connector with one-command installer (ugreen-agent init). Phase 3: photo curation and NAS-event bridge for smart-home agent workflows, with a demo video.
Built With
- kiro
