Release
bmeares/Meerschaum
Meerschaum release process — bump version, update changelog, stage dev→main PR, run CI, publish to PyPI, tag, GitHub release, build/push Docker images, rebuild docs on prod VPS.
A skill your agent uses when packaging Docker deployments as 1Panel local app store apps, including GitHub projects, docker-compose.yml files, docker run commands, app metadata, version directories…
Install 1panel App Builder
$ npx skills add arch3rPro/1Panel-Appstore --skill 1panel-app-builder -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install arch3rPro/1Panel-Appstore 1panel-app-builder --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/arch3rPro/1Panel-Appstore.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills .claude/skills/1panel-app-builder && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "1panel-app-builder" agent skill from https://github.com/arch3rPro/1Panel-Appstore/tree/main/skills into .claude/skills/1panel-app-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "1panel-app-builder", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/arch3rPro/1Panel-Appstore/tree/main/skillsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add arch3rPro/1Panel-Appstore --skill 1panel-app-builder -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install arch3rPro/1Panel-Appstore 1panel-app-builder --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/arch3rPro/1Panel-Appstore.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills .agents/skills/1panel-app-builder && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "1panel-app-builder" agent skill from https://github.com/arch3rPro/1Panel-Appstore/tree/main/skills into .agents/skills/1panel-app-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "1panel-app-builder", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add arch3rPro/1Panel-Appstore --skill 1panel-app-builder -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install arch3rPro/1Panel-Appstore 1panel-app-builder --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/arch3rPro/1Panel-Appstore.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills .cursor/skills/1panel-app-builder && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "1panel-app-builder" agent skill from https://github.com/arch3rPro/1Panel-Appstore/tree/main/skills into .cursor/skills/1panel-app-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "1panel-app-builder", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/arch3rPro/1Panel-Appstore.git --path skills--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add arch3rPro/1Panel-Appstore --skill 1panel-app-builder -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install arch3rPro/1Panel-Appstore 1panel-app-builder --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/arch3rPro/1Panel-Appstore.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills .gemini/skills/1panel-app-builder && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "1panel-app-builder" agent skill from https://github.com/arch3rPro/1Panel-Appstore/tree/main/skills into .gemini/skills/1panel-app-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "1panel-app-builder", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install arch3rPro/1Panel-Appstore 1panel-app-builderInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add arch3rPro/1Panel-Appstore --skill 1panel-app-builder -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/arch3rPro/1Panel-Appstore.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills .github/skills/1panel-app-builder && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "1panel-app-builder" agent skill from https://github.com/arch3rPro/1Panel-Appstore/tree/main/skills into .github/skills/1panel-app-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "1panel-app-builder", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add arch3rPro/1Panel-Appstore --skill 1panel-app-builder -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install arch3rPro/1Panel-Appstore 1panel-app-builder --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/arch3rPro/1Panel-Appstore.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills .opencode/skills/1panel-app-builder && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "1panel-app-builder" agent skill from https://github.com/arch3rPro/1Panel-Appstore/tree/main/skills into .opencode/skills/1panel-app-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "1panel-app-builder", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
1panel-app-builder- GitHub stars
- 213
- Token cost
- ~1.3k tokens
- SKILL.md length
- 445 words
- Files
- 12 (incl. scripts, references)
- Skills in repo
- 1
- Repo updated
- First seen
- Licence
- MIT
At a glance
A skill your agent uses when packaging Docker deployments as 1Panel local app store apps, including GitHub projects, docker-compose.yml files, docker run commands, app metadata, version directories…
- Works in 5 steps: Inspect the source deployment. → Choose a stable app key. → Generate or edit app files. → …
- Packaging Docker deployments as 1Panel local app store apps
- SKILL.md covers When To Use, Required Shape, Workflow and 1Panel Rules, plus 4 more sections
- Runs Shell scripts from its folder; calls docker
What it does
1panel App Builder is an agent skill from arch3rPro/1Panel-Appstore. Use when packaging Docker deployments as 1Panel local app store apps, including GitHub projects, docker-compose.yml files, docker run commands, app metadata, version directories, icons, README files, and 1Panel validation.
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 17 other files, including scripts and reference files (for example `README.md`, `evals/evals.json` and `examples/example-usage.md`).
It sits in DevOps & Cloud, covering Containers, App store release and Deployment. It works with Docker and GitHub. The repository describes itself as: 1Panel-第三方应用商店(运维监控、免费大模型API、Nas工具、容器管理). The licence is MIT.
When your agent uses it
- Packaging Docker deployments as 1Panel local app store apps
- Including GitHub projects
- Docker-compose.yml files
- Docker run commands
Example prompts
- “/1panel-app-builder”
Requirements
- A Bash shell
- Docker
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Inspect the source deployment.
- Choose a stable app key.
- Generate or edit app files.
- Resolve a real icon.
- Validate before delivery.
What it can do on your machine
Read from SKILL.md and the folder at commit 567ef26. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 3 files in scripts/ (Shell), which the agent can run.
Shell commands in SKILL.md call:
docker
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use docker, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
1panel App Builder loads about 1.3k tokens when it runs, and up to ~3.6k if it reads all its reference files. Until then it costs about 60 tokens; SKILL.md has 445 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from arch3rPro/1Panel-Appstore at commit 567ef26, republished under its MIT licence (© arch3rPro). 445 words, ~1,286 tokens.
Download SKILL.mdSave it as
.claude/skills/1panel-app-builder/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.- name
- 1panel-app-builder
- description
- Use when packaging Docker deployments as 1Panel local app store apps, including GitHub projects, docker-compose.yml files, docker run commands, app metadata, version directories, icons, README files, and 1Panel validation.
1Panel App Builder
Build or review 1Panel local app store packages from Docker deployments.
When To Use
Use this skill when the user asks to:
- Add or package a 1Panel local app store app.
- Convert a GitHub project,
docker-compose.yml, ordocker runcommand intoapps/<app-key>/. - Fix 1Panel app metadata, port variables, compose files, README files, icons, or version directories.
- Validate an app package before commit.
For detailed real app examples, read references/1panel-examples.md only when needed.
Required Shape
apps/<app-key>/
├── data.yml
├── logo.png
├── README.md
├── README_en.md
└── <version>/
├── data.yml
├── docker-compose.yml
└── data/Some apps also include latest/. When both latest/ and a concrete version exist, latest/ must use image tag latest, and the concrete version directory should use the pinned tag.
Workflow
- Inspect the source deployment.
- GitHub: inspect README/deploy docs and registry image; the generator checks common compose paths before README
docker runfallback. - Compose: parse services, image tags, ports, volumes, environment, dependencies.
- Docker run: parse image,
--name,-p/--publish,-v/--volume,-e/--env, and--env-file.
- GitHub: inspect README/deploy docs and registry image; the generator checks common compose paths before README
- Choose a stable app key.
- Lowercase, hyphenated, directory-safe.
additionalProperties.keymust match the directory name.
- Generate or edit app files.
- Prefer
latest/plus a concrete version when a concrete image tag is known. - Preserve source volumes and environment unless they conflict with 1Panel conventions.
- Prefer
- Resolve a real icon.
- Do not create placeholders.
- Use
--icon-mode skipfor drafts,cache-onlyfor offline work, andrequiredwhen an icon is mandatory.
- Validate before delivery.
- Run
skills/scripts/validate-app.sh ./apps/<app-key>. - For Skill script changes, run
skills/tests/run_all.sh.
- Run
1Panel Rules
container_nameshould be${CONTAINER_NAME}.- Services should use
restart: always. - Use external
1panel-network. - Port mappings should use
PANEL_APP_PORT_*variables defined in the versiondata.yml. - Persistent mounts should prefer relative
./data/...paths. - Add
labels: createdBy: "Apps". - Keep metadata tags aligned with top-level
data.yaml.
Preferred port variables:
PANEL_APP_PORT_HTTP
PANEL_APP_PORT_HTTPS
PANEL_APP_PORT_API
PANEL_APP_PORT_ADMIN
PANEL_APP_PORT_PROXY
PANEL_APP_PORT_PROXY_HTTP
PANEL_APP_PORT_PROXY_HTTPS
PANEL_APP_PORT_DB
PANEL_APP_PORT_SSH
PANEL_APP_PORT_S3
PANEL_APP_PORT_SYNCShow full SKILL.md (167 more words)Show less
Scripts
Run from /root/github/1Panel-Appstore/skills unless noted.
Generate a draft:
./scripts/generate-app.sh --app-key my-app --name MyApp --version 1.2.3 --icon-mode skip ./docker-compose.ymlUseful generation options:
--output <dir> Output base directory. Default: ./apps
--app-key <key> Override app directory key.
--name <name> Override display name.
--service <name> Select the main service from a multi-service compose file.
--version <tag> Override concrete version and image tag.
--icon-mode <mode> auto|required|skip|cache-only
--icon-url <url> Download icon from a known URL.
--force Allow overwriting an existing generated directory.
--dry-run Print parsed values without writing files.
--check-deps Check required local tools.Download an icon:
./scripts/download-icon.sh --mode cache-only redis ./logo.png
./scripts/download-icon.sh --mode required --url https://example.com/logo.png myapp ./logo.pngValidate an app:
./scripts/validate-app.sh ../apps/<app-key>Validate Skill tooling:
./tests/run_all.shIcon Policy
Icon lookup order:
- Known explicit URL (
--icon-url). - Local cache under
skills/.cache/icons. - Dashboard Icons.
- Simple Icons.
- selfh.st Icons.
Missing icons are acceptable for drafts only. For final app delivery, leave logo.png absent and tell the user what is missing instead of inventing an inaccurate image.
Validation Gate
Before considering an app ready:
- Run
./scripts/validate-app.sh ../apps/<app-key>. - Confirm
latest/uses:latest. - Confirm concrete version directories use matching image tags or document the exception.
- Confirm every compose
PANEL_APP_PORT_*variable exists in the versiondata.yml. - Inspect generated README and metadata manually; the generator is a starting point, not an authority.
Common Mistakes
- Keeping a placeholder
logo.png. - Using a host absolute volume path when
./data/...would work. - Forgetting to define a port variable used by
docker-compose.yml. - Letting
additionalProperties.keydrift from the app directory name. - Treating generated metadata, descriptions, tags, and architectures as final without review.
© arch3rPro, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 11 other files (scripts, references) in skills of arch3rPro/1Panel-Appstore.
- SKILL.md
- README.md
- evals/evals.json
- examples/example-usage.md
- references/1panel-examples.md
- scripts/download-icon.sh
- scripts/generate-app.sh
- scripts/validate-app.sh
- templates/data.yml.tpl
- templates/docker-compose.yml.tpl
- tests/run_all.sh
- tests/test_skills_scripts.sh
Open the folder on GitHubat commit 567ef26
Compare with similar skills
1panel App Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| 1panel App Builder this skillarch3rPro/1Panel-Appstore | 213 | — | ~1.3k | Automated safety check: Pass | MIT | |
| Releasebmeares/Meerschaum | 154 | — | ~1.1k | Automated safety check: Notes | Apache-2.0 | |
| Reflexo ReleaseMyriad-Dreamin/typst.ts | 1.2k | — | ~1.5k | Automated safety check: Pass | Apache-2.0 | |
| Railway Servicedavila7/claude-code-templates | 32k | — | ~1.7k | Automated safety check: Pass | MIT | |
| Perplexity Server DeployescapeWu/perplexity-ai | 169 | — | ~662 | Automated safety check: Notes | MIT | |
| GreptimeDB Dev Docker ImageGreptimeTeam/greptimedb | 6.7k | — | ~4k | Automated safety check: Notes | Apache-2.0 |
Similar skills
Reflexo Release
Myriad-Dreamin/typst.ts
Guide Reflexo/typst.ts release preparation and operator handoffs.
Railway Service
davila7/claude-code-templates
Check service status, rename services, change service icons, link services, or create services with Docker images.
Perplexity Server Deploy
escapeWu/perplexity-ai
Deploys the perplexity-ai project to its production server by pushing main, fast-forwarding the server checkout, rebuilding the image there and verifying health.
GreptimeDB Dev Docker Image
GreptimeTeam/greptimedb
Packages a locally built GreptimeDB debug binary into a development-only Docker image for local-cluster testing, with an optional push to a dev registry.
Senior DevOps Toolkit
maslennikov-ig/claude-code-orchestrator-kit
Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…
Related
Categories
Questions about 1panel App Builder
What does 1panel App Builder do?
A skill your agent uses when packaging Docker deployments as 1Panel local app store apps, including GitHub projects, docker-compose.yml files, docker run commands, app metadata, version directories…. 1panel App Builder is an agent skill from arch3rPro/1Panel-Appstore.yml files, docker run commands, app metadata, version directories, icons, README files, and 1Panel validation.
When should I use 1panel App Builder?
1panel App Builder fits situations like: packaging Docker deployments as 1Panel local app store apps; including GitHub projects; Docker-compose.yml files; Docker run commands.
How do I install 1panel App Builder in Claude Code?
Run `npx skills add arch3rPro/1Panel-Appstore --skill 1panel-app-builder -a claude-code`. Or copy the skill folder (skills in arch3rPro/1Panel-Appstore) into .claude/skills/1panel-app-builder in your project. Claude Code loads it when a task matches its description.
How do I install 1panel App Builder in Codex?
Run `npx skills add arch3rPro/1Panel-Appstore --skill 1panel-app-builder -a codex`. Or copy the skill folder (skills in arch3rPro/1Panel-Appstore) into .agents/skills/1panel-app-builder in your project. Codex loads it when a task matches its description.
Can I use 1panel App Builder in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add arch3rPro/1Panel-Appstore --skill 1panel-app-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/1panel-app-builder, .gemini/skills/1panel-app-builder, .github/skills/1panel-app-builder and .opencode/skills/1panel-app-builder in your project.
What does 1panel App Builder need to run?
Going by SKILL.md and its folder, 1panel App Builder needs a shell for the scripts in its folder and the command-line tools its instructions call (docker). Our summary lists: A Bash shell; Docker.
Does 1panel App Builder access the network?
SKILL.md contains no URLs. Its commands use docker, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is 1panel App Builder safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does 1panel App Builder use?
1panel App Builder is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does 1panel App Builder use?
About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.3k tokens, read only when the agent opens those files.
What are the alternatives to 1panel App Builder?
Skills that share tags, products or a category with 1panel App Builder: Release (bmeares/Meerschaum, 154 stars), Reflexo Release (Myriad-Dreamin/typst.ts, 1.2k stars), Railway Service (davila7/claude-code-templates, 32k stars) and Perplexity Server Deploy (escapeWu/perplexity-ai, 169 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains 1panel App Builder?
arch3rPro (a GitHub user) maintains it in arch3rPro/1Panel-Appstore, which has 213 GitHub stars. The repository was last updated on October 8, 2026.
Source: arch3rPro/1Panel-Appstore on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.