umbrel-app
CommunityPackage, validate, and ship Umbrel apps.
System Documentation
What problem does it solve?
Building, converting, validating, testing, and submitting apps for umbrelOS involves many manual, error-prone steps: composing docker-compose files with correct APP_HOST/APP_PORT, pinning multi-arch image digests, mapping persistent volumes, and preparing submission-ready PRs. This Skill centralizes those tasks so developers can avoid common install failures, bad gateway issues, and insecure or non-deterministic packaging.
Core Features & Use Cases
- Scaffold: Generate a compliant Umbrel app skeleton with docker-compose.yml, umbrel-app.yml, and exports.sh.
- Validate & Lint: Check APP_HOST/APP_PORT formats, image @sha256 multi-arch digests, APP_DATA_DIR usage, restart policies, and manifest fields.
- Convert & Test: Transform Docker Compose projects into Umbrel format, run local/device test flows, and provide debugging commands and remediation steps.
- Submission & Sync: Produce PR-ready content for getumbrel/umbrel-apps, synchronize with upstream stores, and prepare required assets (icons, gallery).
Quick Start
Use the umbrel-app skill to scaffold a new Umbrel app, validate its compose and manifest, and generate a PR-ready package for submission.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: umbrel-app Download link: https://github.com/zot24/skills/archive/main.zip#umbrel-app Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.