1Panel App Builder

Trust Score 80/100

Generate, validate, and package Docker deployments into 1Panel local app store packages; produces app directories, metadata, version directories, and icons suit

triggers:1paneldocker-composepackage appgenerate appvalidate appdownload icon

GitHub SKILL.md

What it does

1Panel App Builder converts Docker deployments (docker-compose, docker run, or GitHub projects) into 1Panel-compatible app packages. It parses compose files, extracts services, ports, volumes and environment variables, and generates the recommended apps/<app-key>/ directory structure with data.yml, version directories, README files, and logo assets. The skill includes validation guidance and scripts to check port variables, version tagging, and icon policies so packages meet 1Panel conventions.

When to use it

Use this skill when you need to onboard a containerized project into a 1Panel local app store, prepare an app for distribution, or validate an existing app package before committing. It's appropriate for converting a GitHub repo or a docker-compose.yml into a structured app, fixing metadata/port variables, or resolving missing icons and version mismatches.

What's included

Scripts: generation and validation scripts (generate-app.sh, validate-app.sh, download-icon.sh) — has_scripts=true.
References: example apps and docs under references/ — has_references=true.
Instructions: workflow steps for inspecting source deployments, choosing stable app keys, generating files, resolving icons, and running validation gates. Guidance covers required directory shape, preferred PANEL_APP_PORT_* variables, and common pitfalls.

Compatible agents

This skill is best used by agents that can run shell scripts and manipulate file trees (CLI-capable agents like Copilot/Codex, local automation agents with shell access). It assumes access to a filesystem, Docker/compose files, and the ability to run the included scripts.

Audit Summary

1Panel App Builder generates Docker-based app packages for the 1Panel local app store. It includes three bash scripts: download-icon.sh (icon fetching from multiple sources), generate-app.sh (main generator from GitHub/compose/docker-run), and validate-app.sh (validates generated packages). The generate script failed due to missing jq/yq deps; the other two ran cleanly showing help text. Well-structured bash with good error handling, logging, and argument parsing. Niche utility targeting 1Panel users specifically.

Watch Out

Requires jq and yq to be installed for the main generate-app.sh script
Scripts assume they run from a specific repo directory structure (/root/github/1Panel-Appstore/skills)
Chinese-language comments and help text throughout — limits accessibility for non-Chinese speakers
Makes network calls to GitHub API, Docker Hub, and GHCR to fetch repo info and latest tags

Missing Dependencies

jqyq

Notes

No security concerns found. Scripts use set -euo pipefail, proper input validation, and no credential hardcoding. Network calls are to well-known public APIs (GitHub, Docker Hub, GHCR, icon CDN services). The curl commands include timeouts and retry limits. No exfiltration or destructive patterns. Niche skill — only useful for 1Panel app store contributors.

Information

Repository: 1panel-appstore
Stars: 159

Trust Score

Overall80

Security88

Code Quality72

Architecture70

Usefulness45

Related Skills

Development Worktree

Create an isolated git worktree for feature work, auto-run project setup, and verify a clean test baseline before development.

Readwise Reader Document Management

Manage Readwise Reader documents: list, save, search, move, tag, highlight, export and bulk-edit via official and custom CLIs.

Bounty Hunter — Atlas

Persona skill: 'Atlas' — a profit-focused developer persona for discovering, evaluating and executing paid bounties or freelance tasks with ROI-aware workflows.

Junshi — Research Advisor

Daily strategic research advisor that scans arXiv/venues, digests papers, and proposes bold, ranked research ideas tailored to the user's profile.

Full Stack Builder

End-to-end builder that scaffolds, implements, tests, and optionally deploys web and API applications from a natural-language specification.

Godot WeChat Minigame Adapter

Apply a version-locked adapter and patch bundle to port an official Godot checkout to WeChat Mini Game, handling WXMEMFS, wasm packaging, audio fixes, and runti

ezBookkeeping API Tools

Command-line API tools for ezBookkeeping: record and query transactions, retrieve accounts/categories/tags, and fetch exchange rates for self-hosted personal fi

Feishu Voice Sender

Convert MP3s and send them as native Feishu voice messages (playable voice clips) to users or groups.

Back to Skills