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.