Agent skill

s3

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.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/s3

Metadata

Additional technical details for this skill

author
Yuga Sun
moltbot 
{
    "emoji": "\u2601\ufe0f",
    "install": [
        {
            "id": "uv-brew",
            "bins": [
                "uv"
            ],
            "kind": "brew",
            "label": "Install uv (brew)",
            "formula": "uv"
        }
    ],
    "requires": {
        "env": [
            "S3_ACCESS_KEY_ID",
            "S3_SECRET_ACCESS_KEY",
            "S3_BUCKET",
            "S3_CUSTOM_DOMAIN"
        ],
        "bins": [
            "uv"
        ]
    },
    "settings": {
        "bucket": {
            "type": "string",
            "label": "Default Bucket",
            "description": "Default Target Bucket"
        },
        "region": {
            "type": "string",
            "label": "Region",
            "description": "S3 Region"
        },
        "endpointUrl": {
            "type": "string",
            "label": "Endpoint URL",
            "description": "S3 Compatible Endpoint URL"
        },
        "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"
}
version
2026.01.29

SKILL.md

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:

bash
# 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.

Didn't find tool you were looking for?

Be as detailed as possible for better results