한국어 |

1panel-appstore-skills는 1Panel App Store 앱 설치 패키지를 만드는 기술입니다.

Docker 기반 배포를 지원하는 애플리케이션을 위해 설계되었습니다. 그것은 공식 저장소, 공식 문서, 도커 이미지, docker-compose.yml, 또는 준비된 중간 spec에서 1Panel App Store 앱 형식을 따르는 패키지를 생성할 수 있습니다.

사용할 때

적당한:

• 1Panel App Store 앱으로 Dockerized 애플리케이션을 포장합니다.
• Docker / Docker Compose 설치 방법을 공식 저장소 또는 공식 문서에서 1Panel 앱 패키지로 변환합니다.
• 기존 docker-compose.yml를 1Panel App Store 디렉토리 구조로 구성합니다.
• data.yml, docker-compose.yml], README 파일 및 준비된 앱 spec의 데이터 디렉토리 생성.

적합하지 않음:

• 신뢰할 수있는 Docker 기반 설치 방법없이 응용.
• 애플리케이션 배포 아키텍처, 이미지, 포트, 데이터 디렉토리, 또는 환경 변수를 발명해야 하는 시나리오.
• 원격 앱 스토어 저장소에 출판. 이 기술은 앱 패키지 콘텐츠를 만 생성합니다.

지원된 입력

• 신청 이름 또는 공식 저장소 URL.

1Panel Appstore Skills

English | 简体中文

1panel-appstore-skills is a skill for creating 1Panel App Store app installation packages.

It is designed for applications that already support Docker-based deployment. It can generate a package that follows the 1Panel App Store app format from official repositories, official documentation, Docker images, docker-compose.yml, or a prepared intermediate spec.

When to Use

Suitable for:

• Packaging a Dockerized application as a 1Panel App Store app.
• Converting Docker / Docker Compose installation methods from official repositories or official documentation into a 1Panel app package.
• Organizing an existing docker-compose.yml into the 1Panel App Store directory structure.
• Generating data.yml, docker-compose.yml, README files, and data directories from a prepared app spec.

Not suitable for:

• Applications without a reliable Docker-based installation method.
• Scenarios that require inventing the application deployment architecture, image, ports, data directories, or environment variables.
• Publishing to a remote app store repository. This skill only generates app package content.

Supported Inputs

• Application name or official repository URL.
• Docker image and required deployment parameters.
• Official docker-compose.yml / compose.yml file.
• Intermediate JSON spec that follows references/appspec.md.

Output

The generated result is a 1Panel App Store app package directory. The default structure is:

apps//
  logo.png
  README.md
  README_en.md
  data.yml
  /
    data.yml
    docker-compose.yml
    data/
    scripts/        # Optional: generated init.sh and manually added lifecycle scripts

Based on the input and official sources, it handles:

• Basic app information, version, type, tags, website, documentation, and repository URL.
• Main service and dependent service images, ports, environment variables, data volumes, and startup dependencies.
• data.yml fields, form fields, and multilingual descriptions required by 1Panel.
• Chinese README; English README when the official application or documentation supports English.
• Persistent directory permission initialization script, generated only when official sources prove it is required.

Project Layout

1panel-appstore-skills/
  README.md
  README.zh-CN.md
  SKILL.md
  assets/
  references/
  scripts/

Core files:

• SKILL.md: defines trigger scenarios, workflow, and packaging rules.
• assets/sample-appspec.json: intermediate spec example, useful for understanding the generation flow.
• references/appstore-format.md: 1Panel app package directory and field rules.
• references/appspec.md: intermediate spec fields and generation boundaries.
• references/review-checklist.md: package review and local testing checklist.