arch3rPro/1Panel-Appstore / skills
1panel-app-builder
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 2.6 KB |
| SKILL.md | skill md | 5.1 KB |
| evals/evals.json | config | 1.6 KB |
| examples/example-usage.md | markdown | 2.3 KB |
| references/1panel-examples.md | markdown | 9.1 KB |
| scripts/download-icon.shexecutable | script | 7.6 KB |
| scripts/generate-app.shexecutable | script | 27.0 KB |
| scripts/validate-app.shexecutable | script | 11.6 KB |
| templates/data.yml.tpl | other | 1.1 KB |
| templates/docker-compose.yml.tpl | other | 396 B |
| tests/run_all.shexecutable | script | 358 B |
| tests/test_skills_scripts.shexecutable | script | 13.4 KB |
tests/test_skills_scripts.sh
View on GitHub#!/usr/bin/env bash
set -euo pipefail
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
TMP_DIR="$(mktemp -d)"
trap 'rm -rf "$TMP_DIR"' EXIT
fail() {
echo "FAIL: $*" >&2
exit 1
}
assert_file() {
[[ -f "$1" ]] || fail "expected file: $1"
}
assert_not_file() {
[[ ! -f "$1" ]] || fail "expected missing file: $1"
}
assert_contains() {
local file="$1"
local pattern="$2"
grep -qE -- "$pattern" "$file" || fail "expected pattern '$pattern' in $file"
}
make_fake_path_without() {
local dir="$1"
shift
mkdir -p "$dir"
local tool
for tool in awk basename cat chmod cmp cp dirname env find grep head mkdir mktemp mv printf rm sed sort tail tr; do
if command -v "$tool" >/dev/null 2>&1; then
ln -s "$(command -v "$tool")" "$dir/$tool"
fi
done
}
run_test() {
local name="$1"
shift
echo "== $name =="
"$@"
}
test_generate_app_reports_missing_dependencies() {
local fake_path="$TMP_DIR/fake-path"
make_fake_path_without "$fake_path"
if PATH="$fake_path" /usr/bin/bash "$ROOT_DIR/skills/scripts/generate-app.sh" --check-deps >/tmp/generate_missing_deps.out 2>&1; then
fail "dependency check should fail when yq/jq/curl are missing"
fi
assert_contains /tmp/generate_missing_deps.out "缺少依赖"
assert_contains /tmp/generate_missing_deps.out "yq"
assert_contains /tmp/generate_missing_deps.out "jq"
assert_contains /tmp/generate_missing_deps.out "curl"
}
test_download_icon_skip_mode_does_not_create_logo() {
local out="$TMP_DIR/skip/logo.png"
bash "$ROOT_DIR/skills/scripts/download-icon.sh" --mode skip demo-app "$out" >/tmp/download_icon_skip.out
assert_not_file "$out"
assert_contains /tmp/download_icon_skip.out "跳过图标下载"
}
test_download_icon_cache_only_uses_cached_logo() {
local cache_dir="$TMP_DIR/icon-cache"
local out="$TMP_DIR/cache/logo.png"
mkdir -p "$cache_dir"
printf 'cached-logo' > "$cache_dir/demo-app.png"
bash "$ROOT_DIR/skills/scripts/download-icon.sh" --mode cache-only --cache-dir "$cache_dir" demo-app "$out" >/tmp/download_icon_cache.out
assert_file "$out"
cmp "$cache_dir/demo-app.png" "$out" || fail "cached logo was not copied"
}
test_generate_app_accepts_explicit_options_and_skips_icon() {
local compose="$TMP_DIR/compose.yml"
local output="$TMP_DIR/generated"
cat > "$compose" <<'YAML'
services:
demo:
image: nginx:1.25.3
ports:
- "18080:80"
YAML
bash "$ROOT_DIR/skills/scripts/generate-app.sh" \
--app-key demo-app \
--name DemoApp \
--version 1.25.3 \
--output "$output" \
--icon-mode skip \
"$compose" >/tmp/generate_app_options.out
assert_file "$output/demo-app/latest/docker-compose.yml"
assert_file "$output/demo-app/1.25.3/docker-compose.yml"
assert_contains "$output/demo-app/data.yml" "^name: DemoApp$"
assert_contains "$output/demo-app/latest/docker-compose.yml" "image: nginx:latest"
assert_contains "$output/demo-app/1.25.3/docker-compose.yml" "image: nginx:1.25.3"
assert_not_file "$output/demo-app/logo.png"
}
test_generate_app_preserves_compose_environment_and_volumes() {
local compose="$TMP_DIR/compose-preserve.yml"
local output="$TMP_DIR/generated-preserve"
cat > "$compose" <<'YAML'
services:
demo:
image: nginx:1.25.3
ports:
- "18080:80"
volumes:
- ./data/nginx:/etc/nginx/conf.d
environment:
- TZ=Asia/Shanghai
- DEMO_FLAG=true
YAML
bash "$ROOT_DIR/skills/scripts/generate-app.sh" \
--app-key demo-preserve \
--name DemoPreserve \
--version 1.25.3 \
--output "$output" \
--icon-mode skip \
"$compose" >/tmp/generate_app_preserve.out
assert_contains "$output/demo-preserve/1.25.3/docker-compose.yml" "./data/nginx:/etc/nginx/conf.d"
assert_contains "$output/demo-preserve/1.25.3/docker-compose.yml" "TZ=Asia/Shanghai"
assert_contains "$output/demo-preserve/1.25.3/docker-compose.yml" "DEMO_FLAG=true"
}
test_generate_app_uses_explicit_compose_service() {
local compose="$TMP_DIR/compose-service.yml"
local output="$TMP_DIR/generated-service"
cat > "$compose" <<'YAML'
services:
db:
image: postgres:16
ports:
- "15432:5432"
web:
image: ghcr.io/example/webapp:2.3.4
ports:
- "18080:8080"
environment:
- WEB_MODE=prod
YAML
bash "$ROOT_DIR/skills/scripts/generate-app.sh" \
--service web \
--app-key demo-service \
--name DemoService \
--version 2.3.4 \
--output "$output" \
--icon-mode skip \
"$compose" >/tmp/generate_app_service.out
assert_contains "$output/demo-service/2.3.4/docker-compose.yml" "web:"
assert_contains "$output/demo-service/2.3.4/docker-compose.yml" "image: ghcr.io/example/webapp:2.3.4"
assert_contains "$output/demo-service/2.3.4/docker-compose.yml" "8080"
assert_contains "$output/demo-service/2.3.4/data.yml" "default: 18080"
assert_contains "$output/demo-service/2.3.4/docker-compose.yml" "WEB_MODE=prod"
}
test_generate_app_discovers_github_default_branch_compose() {
local fixture="$TMP_DIR/github-fixture"
local output="$TMP_DIR/generated-github"
mkdir -p "$fixture/api/repos/example" "$fixture/raw/example/demo/master"
cat > "$fixture/api/repos/example/demo" <<'JSON'
{
"name": "demo",
"description": "Demo GitHub app",
"homepage": "https://demo.example",
"default_branch": "master"
}
JSON
cat > "$fixture/raw/example/demo/master/compose.yaml" <<'YAML'
services:
demo:
image: nginx:1.25.3
ports:
- "18080:80"
YAML
GITHUB_API_BASE_URL="file://${fixture}/api/repos" \
GITHUB_RAW_BASE_URL="file://${fixture}/raw" \
bash "$ROOT_DIR/skills/scripts/generate-app.sh" \
--app-key github-demo \
--version 1.25.3 \
--output "$output" \
--icon-mode skip \
"https://github.com/example/demo" >/tmp/generate_app_github.out
assert_contains "$output/github-demo/data.yml" "Demo GitHub app"
assert_contains "$output/github-demo/1.25.3/docker-compose.yml" "image: nginx:1.25.3"
}
test_generate_app_discovers_github_readme_docker_run() {
local fixture="$TMP_DIR/github-readme-fixture"
local output="$TMP_DIR/generated-github-readme"
mkdir -p "$fixture/api/repos/example" "$fixture/raw/example/readme-demo/main"
cat > "$fixture/api/repos/example/readme-demo" <<'JSON'
{
"name": "readme-demo",
"description": "README docker run app",
"homepage": "",
"default_branch": "main"
}
JSON
cat > "$fixture/raw/example/readme-demo/main/README.md" <<'MD'
# README Demo
```bash
docker run -d --name readme-demo -p 18080:80 -e "APP_TITLE=Readme Demo" nginx:1.25.3
```
MD
GITHUB_API_BASE_URL="file://${fixture}/api/repos" \
GITHUB_RAW_BASE_URL="file://${fixture}/raw" \
bash "$ROOT_DIR/skills/scripts/generate-app.sh" \
--app-key github-readme-demo \
--version 1.25.3 \
--output "$output" \
--icon-mode skip \
"https://github.com/example/readme-demo" >/tmp/generate_app_github_readme.out
assert_contains "$output/github-readme-demo/1.25.3/docker-compose.yml" "image: nginx:1.25.3"
assert_contains "$output/github-readme-demo/1.25.3/docker-compose.yml" "APP_TITLE=Readme Demo"
assert_contains "$output/github-readme-demo/1.25.3/data.yml" "default: 18080"
}
test_generate_app_parses_complex_docker_run_flags() {
local output="$TMP_DIR/generated-run"
bash "$ROOT_DIR/skills/scripts/generate-app.sh" \
--app-key docker-run-demo \
--name DockerRunDemo \
--version 1.2.3 \
--output "$output" \
--icon-mode skip \
'docker run -d --name docker-run-demo --env "APP_TITLE=My Demo" --env-file ./data/app.env --publish=127.0.0.1:18080:8080/tcp --volume=./data/demo:/data ghcr.io/example/demo:1.2.3' >/tmp/generate_app_run.out
assert_contains "$output/docker-run-demo/1.2.3/docker-compose.yml" "image: ghcr.io/example/demo:1.2.3"
assert_contains "$output/docker-run-demo/1.2.3/docker-compose.yml" "APP_TITLE=My Demo"
assert_contains "$output/docker-run-demo/1.2.3/docker-compose.yml" "./data/demo:/data"
assert_contains "$output/docker-run-demo/1.2.3/docker-compose.yml" "8080"
}
test_validate_app_rejects_undefined_port_variable() {
local app="$TMP_DIR/bad-port/apps/demo-app"
mkdir -p "$app/1.0.0"
printf 'png' > "$app/logo.png"
cat > "$app/data.yml" <<'YAML'
name: DemoApp
tags:
- 实用工具
title: Demo
description: Demo
additionalProperties:
key: demo-app
name: DemoApp
architectures:
- amd64
YAML
cat > "$app/1.0.0/data.yml" <<'YAML'
additionalProperties:
formFields:
- default: 8080
edit: true
envKey: PANEL_APP_PORT_HTTP
labelEn: Web Port
labelZh: Web端口
required: true
rule: paramPort
type: number
YAML
cat > "$app/1.0.0/docker-compose.yml" <<'YAML'
services:
demo:
container_name: ${CONTAINER_NAME}
restart: always
networks:
- 1panel-network
ports:
- "${PANEL_APP_PORT_ADMIN}:80"
image: nginx:1.0.0
labels:
createdBy: "Apps"
networks:
1panel-network:
external: true
YAML
if bash "$ROOT_DIR/skills/scripts/validate-app.sh" "$app" >/tmp/validate_bad_port.out 2>&1; then
fail "validator should reject undefined port variable"
fi
assert_contains /tmp/validate_bad_port.out "未在版本 data.yml 中定义"
}
test_validate_app_rejects_latest_wrong_tag() {
local app="$TMP_DIR/bad-latest/apps/demo-app"
mkdir -p "$app/latest"
printf 'png' > "$app/logo.png"
cat > "$app/data.yml" <<'YAML'
name: DemoApp
tags:
- 实用工具
title: Demo
description: Demo
additionalProperties:
key: demo-app
name: DemoApp
architectures:
- amd64
YAML
cat > "$app/latest/data.yml" <<'YAML'
additionalProperties:
formFields: []
YAML
cat > "$app/latest/docker-compose.yml" <<'YAML'
services:
demo:
container_name: ${CONTAINER_NAME}
restart: always
networks:
- 1panel-network
image: demo/demo-app:1.25.3
labels:
createdBy: "Apps"
networks:
1panel-network:
external: true
YAML
if bash "$ROOT_DIR/skills/scripts/validate-app.sh" "$app" >/tmp/validate_bad_latest.out 2>&1; then
fail "validator should reject latest directory with concrete tag"
fi
assert_contains /tmp/validate_bad_latest.out "latest 目录"
}
test_validate_app_accepts_v_prefixed_version_tag() {
local app="$TMP_DIR/v-prefix/apps/demo-app"
mkdir -p "$app/1.2.3"
printf 'png' > "$app/logo.png"
cat > "$app/data.yml" <<'YAML'
name: DemoApp
tags:
- 实用工具
title: Demo
description: Demo
additionalProperties:
key: demo-app
name: DemoApp
architectures:
- amd64
YAML
cat > "$app/1.2.3/data.yml" <<'YAML'
additionalProperties:
formFields: []
YAML
cat > "$app/1.2.3/docker-compose.yml" <<'YAML'
services:
demo:
container_name: ${CONTAINER_NAME}
restart: always
networks:
- 1panel-network
image: demo/demo-app:v1.2.3
labels:
createdBy: "Apps"
networks:
1panel-network:
external: true
YAML
bash "$ROOT_DIR/skills/scripts/validate-app.sh" "$app" >/tmp/validate_v_prefix.out 2>&1
if grep -q "未检测到与目录名一致的镜像 tag" /tmp/validate_v_prefix.out; then
cat /tmp/validate_v_prefix.out >&2
fail "validator should accept v-prefixed tag for version directory"
fi
}
test_validate_app_detects_named_version_directory() {
local app="$TMP_DIR/named-version/apps/demo-app"
mkdir -p "$app/chromium-bundled-2026-07-06"
printf 'png' > "$app/logo.png"
cat > "$app/data.yml" <<'YAML'
name: DemoApp
tags:
- 实用工具
title: Demo
description: Demo
additionalProperties:
key: demo-app
name: DemoApp
architectures:
- amd64
YAML
cat > "$app/chromium-bundled-2026-07-06/data.yml" <<'YAML'
additionalProperties:
formFields: []
YAML
cat > "$app/chromium-bundled-2026-07-06/docker-compose.yml" <<'YAML'
services:
demo:
container_name: ${CONTAINER_NAME}
restart: always
networks:
- 1panel-network
image: demo/demo-app:chromium-bundled-2026-07-06
labels:
createdBy: "Apps"
networks:
1panel-network:
external: true
YAML
bash "$ROOT_DIR/skills/scripts/validate-app.sh" "$app" >/tmp/validate_named_version.out 2>&1
assert_contains /tmp/validate_named_version.out "检查版本目录: chromium-bundled-2026-07-06"
if grep -q "未找到版本目录" /tmp/validate_named_version.out; then
cat /tmp/validate_named_version.out >&2
fail "validator should detect named version directory"
fi
}
run_test "download icon skip mode" test_download_icon_skip_mode_does_not_create_logo
run_test "download icon cache-only mode" test_download_icon_cache_only_uses_cached_logo
run_test "generate app dependency check" test_generate_app_reports_missing_dependencies
run_test "generate app explicit options" test_generate_app_accepts_explicit_options_and_skips_icon
run_test "generate app preserves compose fields" test_generate_app_preserves_compose_environment_and_volumes
run_test "generate app explicit compose service" test_generate_app_uses_explicit_compose_service
run_test "generate app github compose discovery" test_generate_app_discovers_github_default_branch_compose
run_test "generate app github README docker run discovery" test_generate_app_discovers_github_readme_docker_run
run_test "generate app complex docker run flags" test_generate_app_parses_complex_docker_run_flags
run_test "validate undefined port variable" test_validate_app_rejects_undefined_port_variable
run_test "validate latest image tag" test_validate_app_rejects_latest_wrong_tag
run_test "validate v-prefixed version tag" test_validate_app_accepts_v_prefixed_version_tag
run_test "validate named version directory" test_validate_app_detects_named_version_directory
echo "All skills script tests passed."
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |