Homepage Icon Finder
Use when setting icon values for Homepage (gethomepage.dev) dashboard services, or when homepage icons appear broken/missing. Triggers on homepage YAML configs with icon fields.
Install
$ agentstack add skill-derio-net-agent-skills-homepage-icon-finder ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
Homepage Icon Finder
Find and verify icons for Homepage dashboard service entries.
Icon Sources & Prefixes
| Prefix | Source | Example | Search URL | |--------|--------|---------|------------| | (none) | Dashboard Icons | argo-cd | Fetch https://cdn.jsdelivr.net/gh/walkxcode/dashboard-icons/tree.json | | si- | Simple Icons | si-github | Fetch https://raw.githubusercontent.com/simple-icons/simple-icons/master/slugs.md | | sh- | selfh.st Icons | sh-nextcloud | Fetch https://raw.githubusercontent.com/selfhst/icons/refs/heads/main/index.json | | mdi- | Material Design Icons | mdi-flask-outline | Search https://pictogrammers.com/library/mdi/ | | URL | Direct image | https://example.com/logo.png | N/A | | /icons/ | Local mount | /icons/myapp.png | Mount to /app/public/icons in container |
Lookup Procedure
- Search Dashboard Icons first (highest quality, purpose-built for dashboards):
`` WebFetch https://cdn.jsdelivr.net/gh/walkxcode/dashboard-icons/tree.json → search for service name and common aliases ` Names use hyphens: argo-cd, home-assistant, pi-hole, visual-studio-code`
- Try Simple Icons if not found (brand logos):
`` WebFetch https://raw.githubusercontent.com/simple-icons/simple-icons/master/slugs.md → search for brand name ` Slugs are lowercase, no hyphens: argo, kubernetes, grafana`
- Try selfh.st for self-hosted app icons:
`` WebFetch https://raw.githubusercontent.com/selfhst/icons/refs/heads/main/index.json → search for app name ``
- Fall back to MDI for generic icons:
mdi-server,mdi-kubernetes,mdi-robot
- Last resort: Direct URL to the project's logo from their GitHub/website
Color Customization
For si- and mdi- icons, append hex color: si-github-#181717, mdi-server-#4CAF50
Common Gotchas
| Service | Wrong | Right | Why | |---------|-------|-------|-----| | ArgoCD | argocd, si-argocd | argo-cd (dashboard) or si-argo (simple) | Dashboard Icons uses hyphenated name; Simple Icons slug is just argo | | Pi-hole | pihole | pi-hole | Dashboard Icons uses hyphen | | Home Assistant | homeassistant | home-assistant | Dashboard Icons uses hyphen | | Sidero Omni | sidero-omni, si-sidero | /icons/sidero-omni.png (local mount) | Not in any icon registry; committed to docs/icons/, copied into container by role | | KubeVirt | kubevirt, si-kubevirt | https://raw.githubusercontent.com/kubevirt/community/main/logo/KubeVirt_icon.svg | Not in any icon registry; use direct GitHub URL |
Verification
After setting an icon, the only true verification is loading the Homepage dashboard. However, you can pre-verify by checking the icon exists in the source registry using the search URLs above.
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: derio-net
- Source: derio-net/agent-skills
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.