Skip to content

arch3rPro/1Panel-Appstore / skills

1panel-app-builder

Verified

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.

FileKindSize
README.mdmarkdown2.6 KB
SKILL.mdskill md5.1 KB
evals/evals.jsonconfig1.6 KB
examples/example-usage.mdmarkdown2.3 KB
references/1panel-examples.mdmarkdown9.1 KB
scripts/download-icon.shexecutablescript7.6 KB
scripts/generate-app.shexecutablescript27.0 KB
scripts/validate-app.shexecutablescript11.6 KB
templates/data.yml.tplother1.1 KB
templates/docker-compose.yml.tplother396 B
tests/run_all.shexecutablescript358 B
tests/test_skills_scripts.shexecutablescript13.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."
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 119kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall