---

name: s3 description: Uploads generated static sites or files (like slides) to AWS S3 or S3-compatible services (MinIO, Aliyun OSS, etc.) for public access. Use this skill when the user wants to publish or deploy their content to the cloud. metadata: author: Yuga Sun version: "2026.01.29" moltbot: emoji: "☁️" requires: bins: ["uv"] env: ["S3_ACCESS_KEY_ID", "S3_SECRET_ACCESS_KEY", "S3_BUCKET", "S3_CUSTOM_DOMAIN"] settings: endpointUrl: type: string label: Endpoint URL description: S3 Compatible Endpoint URL region: type: string label: Region description: S3 Region bucket: type: string label: Default Bucket description: Default Target Bucket customDomain: type: string label: Custom Domain description: Custom domain for generated link (e.g., https://cdn.example.com) addressingStyle: type: string label: Addressing Style description: auto, virtual, or path (use virtual for Aliyun) signatureVersion: type: string label: Signature Version description: e.g. s3 or s3v4 (use s3 for Aliyun) primaryEnv: S3_ACCESS_KEY_ID install: - id: uv-brew kind: brew formula: uv bins: ["uv"] label: Install uv (brew)

S3 Deployment Skill

Instructions

This skill handles uploading a local directory (e.g., generated slides) to an AWS S3 bucket or any S3-compatible object storage (e.g., MinIO, Aliyun OSS, Tencent COS) for static website hosting.

1. Prerequisites:

   • Ensure the user has valid credentials in their environment:
     • S3_ACCESS_KEY_ID
     • S3_SECRET_ACCESS_KEY
     • S3_BUCKET (Optional if provided as an argument)
     • S3_REGION (Optional)
     • S3_ENDPOINT_URL (Required for non-AWS services like MinIO or Aliyun OSS)
     • S3_CUSTOM_DOMAIN (Optional, overrides the generated URL)
   • Ensure boto3 is installed in the environment. If not, install it.
   • Identify the source directory (e.g., slides/<ppt-name>/dist/) and the target S3 bucket name.

2. Implementation:

   • Create a Python script using boto3 to walk through the source directory.
   • Configure the S3 client with endpoint_url if provided, to support S3-compatible providers.
   • Upload each file, maintaining the relative path structure.
   • Crucial: specific ContentType must be set for each file based on its extension (e.g., text/html for .html, text/css for .css, image/png for .png) so that the browser renders it correctly.
   • Make the objects public if the bucket policy allows or requires ACL (optional, based on bucket configuration).
   • Print the final website URL.

Usage

Use the bundled script to upload files:

# Explicit bucket name
uv run {baseDir}/scripts/upload_to_s3.py "slides/my-presentation/dist" "my-bucket" --prefix "presentations/my-presentation"

# Using S3_BUCKET from environment
uv run {baseDir}/scripts/upload_to_s3.py "slides/my-presentation/dist" --prefix "presentations/my-presentation"

Usage Guidelines

• Bucket Name: Check if S3_BUCKET is set in environment. If not, ask the user for the S3 Bucket name.
• Endpoint URL: Check if the user is using a non-AWS provider (like MinIO or Aliyun). If so, request or verify the endpoint_url.
• Source Path: Default to looking for dist folders in slides/ if not specified.