aiskillstore/marketplace / skills/aayushbaniya2006/s3-upload-handler
s3-upload-handler
VerifiedHandle S3 file uploads including UI components, client-side logic, and server-side processing
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.3 KB |
| reference.md | markdown | 1.3 KB |
| skill-report.json | config | 35.3 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-06T01:00:31.599Z",
"slug": "aayushbaniya2006-s3-upload-handler",
"source_url": "https://github.com/AayushBaniya2006/blinkfund/tree/main/.claude/skills/s3-upload-handler",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "235a3134d89f300e2235fa52a77379600d7ef6c4c8c6c74f0c108d10a86086ed",
"tree_hash": "d9a74d47457d1b086c1b72745456af3f45fdba0edb6844ff7624324c448889be",
"provenance": {
"model_requested": "gpt-5.5:high",
"model_effective": "codex:gpt-5.5:high",
"fallback_chain": [
{
"agent": "codex",
"model": "gpt-5.5",
"effort": "high",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "s3-upload-handler",
"description": "Guide implementation of AWS S3 uploads with UI components, client upload logic, and server-side processing.",
"summary": "Adds practical S3 upload guidance for web apps using presigned upload flows.",
"icon": "📦",
"version": "1.0.0",
"author": "AayushBaniya2006",
"license": "MIT",
"tags": [
"aws-s3",
"file-uploads",
"presigned-urls",
"nextjs",
"typescript"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"external_commands",
"env_access"
],
"category": "coding"
},
"security_audit": {
"risk_level": "high",
"is_blocked": false,
"safe_to_publish": false,
"analysis_status": "ok",
"summary": "Most external-command findings are false positives from Markdown inline code and fenced TypeScript examples, with no shell execution. The AWS credential and .env.local guidance is confirmed as sensitive secret handling, and the presigned upload example adds a high-risk concern because it lacks visible access control and uses public-read uploads.",
"remediation": [
{
"issue": "AWS credentials are documented in .env.local.",
"suggestion": "Prefer managed AWS credentials, short-lived roles, or deployment platform secrets. Warn agents not to read, print, or commit .env.local values.",
"severity": "high"
},
{
"issue": "The presigned upload route omits authentication and authorization.",
"suggestion": "Require an authenticated user, authorize the upload prefix, bind keys to an owner, and reject requests outside the allowed tenant or account scope.",
"severity": "high"
},
{
"issue": "The example allows client-controlled file type and public-read objects.",
"suggestion": "Validate MIME type and extension on the server, use private object ACLs, and serve files through signed read URLs or a controlled CDN policy.",
"severity": "high"
},
{
"issue": "The S3 key includes the original file name from the request.",
"suggestion": "Normalize file names, reject path separators and unsafe characters, and generate server-controlled object keys for each upload.",
"severity": "medium"
}
],
"risk_factor_evidence": [
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 14,
"line_end": 14
},
{
"file": "SKILL.md",
"line_start": 15,
"line_end": 15
},
{
"file": "SKILL.md",
"line_start": 16,
"line_end": 16
},
{
"file": "SKILL.md",
"line_start": 22,
"line_end": 22
},
{
"file": "SKILL.md",
"line_start": 24,
"line_end": 38
},
{
"file": "SKILL.md",
"line_start": 38,
"line_end": 42
},
{
"file": "SKILL.md",
"line_start": 42,
"line_end": 44
},
{
"file": "SKILL.md",
"line_start": 44,
"line_end": 54
},
{
"file": "SKILL.md",
"line_start": 54,
"line_end": 58
},
{
"file": "SKILL.md",
"line_start": 58,
"line_end": 60
},
{
"file": "SKILL.md",
"line_start": 60,
"line_end": 69
},
{
"file": "SKILL.md",
"line_start": 69,
"line_end": 73
},
{
"file": "SKILL.md",
"line_start": 73,
"line_end": 75
},
{
"file": "SKILL.md",
"line_start": 75,
"line_end": 80
},
{
"file": "SKILL.md",
"line_start": 80,
"line_end": 86
},
{
"file": "SKILL.md",
"line_start": 86,
"line_end": 98
},
{
"file": "SKILL.md",
"line_start": 98,
"line_end": 112
}
]
},
{
"factor": "env_access",
"evidence": [
{
"file": "SKILL.md",
"line_start": 94,
"line_end": 94
},
{
"file": "SKILL.md",
"line_start": 97,
"line_end": 97
},
{
"file": "SKILL.md",
"line_start": 94,
"line_end": 94
},
{
"file": "SKILL.md",
"line_start": 97,
"line_end": 97
},
{
"file": "SKILL.md",
"line_start": 76,
"line_end": 76
},
{
"file": "SKILL.md",
"line_start": 77,
"line_end": 77
}
]
}
],
"static_findings": [
{
"id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 14,
"line_end": 14,
"snippet": "1. **UI Component**: Ready-to-use `S3Uploader` for drag-and-drop or button uploads."
},
{
"id": "external_commands:SKILL.md:15:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 15,
"line_end": 15,
"snippet": "2. **Client SDK**: `ClientS3Uploader` class for custom upload interfaces."
},
{
"id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 16,
"line_end": 16,
"snippet": "3. **Server Utilities**: `uploadFromServer` for backend file processing and uploading."
},
{
"id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 22,
"line_end": 22,
"snippet": "Use the `S3Uploader` component for most user-facing upload needs."
},
{
"id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 24,
"line_end": 38,
"snippet": "```tsx"
},
{
"id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 38,
"line_end": 42,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 42,
"line_end": 44,
"snippet": "Use `ClientS3Uploader` when you need full control over the UI (e.g., hidden inputs, custom buttons)."
},
{
"id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 44,
"line_end": 54,
"snippet": "```tsx"
},
{
"id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 54,
"line_end": 58,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 58,
"line_end": 60,
"snippet": "Use `uploadFromServer` in API routes or Server Actions for processing files (resizing, generating PD"
},
{
"id": "external_commands:SKILL.md:60:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 60,
"line_end": 69,
"snippet": "```typescript"
},
{
"id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 69,
"line_end": 73,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 73,
"line_end": 75,
"snippet": "Ensure `.env.local` has the necessary AWS credentials:"
},
{
"id": "external_commands:SKILL.md:75:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 75,
"line_end": 80,
"snippet": "```env"
},
{
"id": "external_commands:SKILL.md:80:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 80,
"line_end": 86,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 86,
"line_end": 98,
"snippet": "```typescript"
},
{
"id": "external_commands:SKILL.md:98:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 98,
"line_end": 112,
"snippet": "Key: `uploads/${uuidv4()}-${fileName}`,"
},
{
"id": "env_access:SKILL.md:94:environment-variable-access-dot-notation",
"category": "env_access",
"severity": "low",
"pattern": "Environment variable access (dot notation)",
"file": "SKILL.md",
"line_start": 94,
"line_end": 94,
"snippet": "const client = new S3Client({ region: process.env.AWS_REGION });"
},
{
"id": "env_access:SKILL.md:97:environment-variable-access-dot-notation",
"category": "env_access",
"severity": "low",
"pattern": "Environment variable access (dot notation)",
"file": "SKILL.md",
"line_start": 97,
"line_end": 97,
"snippet": "Bucket: process.env.AWS_S3_BUCKET_NAME!,"
},
{
"id": "env_access:SKILL.md:94:environment-variable-object",
"category": "env_access",
"severity": "low",
"pattern": "Environment variable object",
"file": "SKILL.md",
"line_start": 94,
"line_end": 94,
"snippet": "const client = new S3Client({ region: process.env.AWS_REGION });"
},
{
"id": "env_access:SKILL.md:97:environment-variable-object",
"category": "env_access",
"severity": "low",
"pattern": "Environment variable object",
"file": "SKILL.md",
"line_start": 97,
"line_end": 97,
"snippet": "Bucket: process.env.AWS_S3_BUCKET_NAME!,"
},
{
"id": "env_access:SKILL.md:76:aws-credential-environment-variables",
"category": "env_access",
"severity": "high",
"pattern": "AWS credential environment variables",
"file": "SKILL.md",
"line_start": 76,
"line_end": 76,
"snippet": "AWS_ACCESS_KEY_ID=\"your-access-key\""
},
{
"id": "env_access:SKILL.md:77:aws-credential-environment-variables",
"category": "env_access",
"severity": "high",
"pattern": "AWS credential environment variables",
"file": "SKILL.md",
"line_start": 77,
"line_end": 77,
"snippet": "AWS_SECRET_ACCESS_KEY=\"your-secret-key\""
},
{
"id": "sensitive:SKILL.md:73:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "SKILL.md",
"line_start": 73,
"line_end": 73,
"snippet": "Ensure `.env.local` has the necessary AWS credentials:"
},
{
"id": "sensitive:SKILL.md:94:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "SKILL.md",
"line_start": 94,
"line_end": 94,
"snippet": "const client = new S3Client({ region: process.env.AWS_REGION });"
},
{
"id": "sensitive:SKILL.md:97:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "SKILL.md",
"line_start": 97,
"line_end": 97,
"snippet": "Bucket: process.env.AWS_S3_BUCKET_NAME!,"
},
{
"id": "sensitive:SKILL.md:73:environment-variant-files",
"category": "sensitive",
"severity": "high",
"pattern": "Environment variant files",
"file": "SKILL.md",
"line_start": 73,
"line_end": 73,
"snippet": "Ensure `.env.local` has the necessary AWS credentials:"
}
],
"finding_verdicts": [
{
"id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The matched backticks are Markdown inline code used to name components, helpers, or files. This is documentation formatting, not shell command execution."
},
{
"id": "external_commands:SKILL.md:15:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The matched backticks are Markdown inline code used to name components, helpers, or files. This is documentation formatting, not shell command execution."
},
{
"id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The matched backticks are Markdown inline code used to name components, helpers, or files. This is documentation formatting, not shell command execution."
},
{
"id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The matched backticks are Markdown inline code used to name components, helpers, or files. This is documentation formatting, not shell command execution."
},
{
"id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text is a Markdown fenced code block marker around TypeScript or env examples. It does not instruct the agent to run a shell command or execute external programs."
},
{
"id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text is a Markdown fenced code block marker around TypeScript or env examples. It does not instruct the agent to run a shell command or execute external programs."
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The matched backticks are Markdown inline code used to name components, helpers, or files. This is documentation formatting, not shell command execution."
},
{
"id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text is a Markdown fenced code block marker around TypeScript or env examples. It does not instruct the agent to run a shell command or execute external programs."
},
{
"id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text is a Markdown fenced code block marker around TypeScript or env examples. It does not instruct the agent to run a shell command or execute external programs."
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The matched backticks are Markdown inline code used to name components, helpers, or files. This is documentation formatting, not shell command execution."
},
{
"id": "external_commands:SKILL.md:60:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text is a Markdown fenced code block marker around TypeScript or env examples. It does not instruct the agent to run a shell command or execute external programs."
},
{
"id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text is a Markdown fenced code block marker around TypeScript or env examples. It does not instruct the agent to run a shell command or execute external programs."
},
{
"id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The matched backticks are Markdown inline code used to name components, helpers, or files. This is documentation formatting, not shell command execution."
},
{
"id": "external_commands:SKILL.md:75:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text is a Markdown fenced code block marker around TypeScript or env examples. It does not instruct the agent to run a shell command or execute external programs."
},
{
"id": "external_commands:SKILL.md:80:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text is a Markdown fenced code block marker around TypeScript or env examples. It does not instruct the agent to run a shell command or execute external programs."
},
{
"id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text is a Markdown fenced code block marker around TypeScript or env examples. It does not instruct the agent to run a shell command or execute external programs."
},
{
"id": "external_commands:SKILL.md:98:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The backticks are a TypeScript template literal constructing an S3 key in an example, not Ruby shell execution. There is no shell invocation or external command runner at this location."
},
{
"id": "env_access:SKILL.md:94:environment-variable-access-dot-notation",
"verdict": "false_positive",
"confidence": 0.82,
"reason": "The code reads AWS_REGION or AWS_S3_BUCKET_NAME in a server-side S3 configuration example. These are configuration values, not secret credentials, and no exfiltration path is shown."
},
{
"id": "env_access:SKILL.md:97:environment-variable-access-dot-notation",
"verdict": "false_positive",
"confidence": 0.82,
"reason": "The code reads AWS_REGION or AWS_S3_BUCKET_NAME in a server-side S3 configuration example. These are configuration values, not secret credentials, and no exfiltration path is shown."
},
{
"id": "env_access:SKILL.md:94:environment-variable-object",
"verdict": "false_positive",
"confidence": 0.82,
"reason": "The code reads AWS_REGION or AWS_S3_BUCKET_NAME in a server-side S3 configuration example. These are configuration values, not secret credentials, and no exfiltration path is shown."
},
{
"id": "env_access:SKILL.md:97:environment-variable-object",
"verdict": "false_positive",
"confidence": 0.82,
"reason": "The code reads AWS_REGION or AWS_S3_BUCKET_NAME in a server-side S3 configuration example. These are configuration values, not secret credentials, and no exfiltration path is shown."
},
{
"id": "env_access:SKILL.md:76:aws-credential-environment-variables",
"verdict": "confirmed",
"confidence": 0.78,
"reason": "The documentation tells users to place an AWS access key identifier in .env.local as part of the setup. This creates a sensitive credential-handling workflow that agents may read or modify.",
"severity": "high"
},
{
"id": "env_access:SKILL.md:77:aws-credential-environment-variables",
"verdict": "confirmed",
"confidence": 0.88,
"reason": "The documentation tells users to place AWS_SECRET_ACCESS_KEY in .env.local. That is a long-lived secret and should be treated as a high-risk credential handling pattern.",
"severity": "high"
},
{
"id": "sensitive:SKILL.md:73:environment-file-access",
"verdict": "confirmed",
"confidence": 0.86,
"reason": "The guidance explicitly references .env.local as the place for AWS credentials. That can lead an agent to inspect or edit a sensitive environment file.",
"severity": "high"
},
{
"id": "sensitive:SKILL.md:94:environment-file-access",
"verdict": "false_positive",
"confidence": 0.79,
"reason": "This line reads non-secret server configuration through process.env and does not directly access .env.local or expose a credential. The sensitive-file match is therefore not supported at this location."
},
{
"id": "sensitive:SKILL.md:97:environment-file-access",
"verdict": "false_positive",
"confidence": 0.79,
"reason": "This line reads non-secret server configuration through process.env and does not directly access .env.local or expose a credential. The sensitive-file match is therefore not supported at this location."
},
{
"id": "sensitive:SKILL.md:73:environment-variant-files",
"verdict": "confirmed",
"confidence": 0.86,
"reason": "The line directs setup through .env.local, an environment variant file that commonly stores secrets. This is a real sensitive-file handling concern.",
"severity": "high"
}
],
"semantic_findings": [
{
"title": "Presigned Upload Route Lacks Access Controls",
"description": "The API route example creates a presigned S3 upload from request-supplied fileName and fileType, sets uploaded objects to public-read, and does not show authentication, authorization, server-side type allowlists, or ownership checks. If copied as-is, it could allow unauthorized public uploads to the bucket.",
"severity": "high",
"locations": [
{
"file": "SKILL.md",
"line_start": 92,
"line_end": 110
}
],
"confidence": 0.86,
"confidence_reasoning": "The example shows the complete POST handler and omits access control while granting public-read on line 104. Legitimate projects may add checks elsewhere, but the skill presents this route as the typical pattern."
}
],
"critical_findings": [],
"high_findings": [
{
"title": "AWS credential environment variables",
"description": "AWS_ACCESS_KEY_ID=\"your-access-key\"",
"locations": [
{
"file": "SKILL.md",
"line_start": 76,
"line_end": 76
}
],
"review_kind": "capability",
"source_category": "env_access",
"source_severity": "high",
"confidence": 0.78,
"confidence_reasoning": "The documentation tells users to place an AWS access key identifier in .env.local as part of the setup. This creates a sensitive credential-handling workflow that agents may read or modify."
},
{
"title": "AWS credential environment variables",
"description": "AWS_SECRET_ACCESS_KEY=\"your-secret-key\"",
"locations": [
{
"file": "SKILL.md",
"line_start": 77,
"line_end": 77
}
],
"review_kind": "capability",
"source_category": "env_access",
"source_severity": "high",
"confidence": 0.88,
"confidence_reasoning": "The documentation tells users to place AWS_SECRET_ACCESS_KEY in .env.local. That is a long-lived secret and should be treated as a high-risk credential handling pattern."
},
{
"title": "Environment file access",
"description": "Ensure `.env.local` has the necessary AWS credentials:",
"locations": [
{
"file": "SKILL.md",
"line_start": 73,
"line_end": 73
}
],
"review_kind": "security",
"source_category": "sensitive",
"source_severity": "high",
"confidence": 0.86,
"confidence_reasoning": "The guidance explicitly references .env.local as the place for AWS credentials. That can lead an agent to inspect or edit a sensitive environment file."
},
{
"title": "Environment variant files",
"description": "Ensure `.env.local` has the necessary AWS credentials:",
"locations": [
{
"file": "SKILL.md",
"line_start": 73,
"line_end": 73
}
],
"review_kind": "security",
"source_category": "sensitive",
"source_severity": "high",
"confidence": 0.86,
"confidence_reasoning": "The line directs setup through .env.local, an environment variant file that commonly stores secrets. This is a real sensitive-file handling concern."
},
{
"title": "Presigned Upload Route Lacks Access Controls",
"description": "The API route example creates a presigned S3 upload from request-supplied fileName and fileType, sets uploaded objects to public-read, and does not show authentication, authorization, server-side type allowlists, or ownership checks. If copied as-is, it could allow unauthorized public uploads to the bucket.",
"locations": [
{
"file": "SKILL.md",
"line_start": 92,
"line_end": 110
}
],
"review_kind": "security",
"source_category": "semantic",
"source_severity": "high",
"confidence": 0.86,
"confidence_reasoning": "The example shows the complete POST handler and omits access control while granting public-read on line 104. Legitimate projects may add checks elsewhere, but the skill presents this route as the typical pattern."
}
],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 2,
"total_lines": 161,
"audit_model": "codex",
"audited_at": "2026-07-06T01:00:31.599Z",
"agent_auto_install_policy": "confirmation_required",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Add S3 Uploads to Your App",
"value_statement": "Building file uploads takes UI, client logic, and server routes. This skill guides Claude, Codex, and Claude Code through S3 upload patterns for web apps.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"S3 uploads",
"AWS S3",
"presigned URLs",
"file upload component",
"Next.js uploads",
"server upload utility",
"drag and drop upload"
],
"actual_capabilities": [
"Explains when to use the S3Uploader component for button or dropzone uploads.",
"Shows how ClientS3Uploader supports custom client-side upload interfaces.",
"Describes server-side uploads for generated or processed files.",
"Lists S3Uploader props such as maxFiles, maxSize, accept, multiple, value, and onChange.",
"Provides an AWS SDK presigned post route example for browser uploads.",
"Identifies required AWS environment configuration for region and bucket settings."
],
"limitations": [
"The skill package contains guidance and references, not the referenced implementation source files.",
"Projects still need an AWS account, S3 bucket, IAM policy, and required SDK packages.",
"Authentication, authorization, validation, and private access controls must be added by the developer.",
"The examples assume TypeScript, React, and Next.js style project structure."
],
"use_cases": [
{
"title": "Add User Avatar Uploads",
"description": "Use the button variant to guide a simple single-file upload flow for profile images.",
"target_user": "Application developer"
},
{
"title": "Build Project File Dropzones",
"description": "Use the dropzone pattern with file count and size limits for multi-file workflows.",
"target_user": "Product engineer"
},
{
"title": "Upload Generated Server Files",
"description": "Use the server utility pattern when API routes or server actions create files before storage.",
"target_user": "Backend developer"
}
],
"prompt_templates": [
{
"title": "Plan a Basic Upload",
"scenario": "Beginner setup for a standard page upload.",
"prompt": "Use this skill to plan a simple S3 upload flow for a Next.js page. Recommend the component, required props, and setup steps."
},
{
"title": "Customize Upload UI",
"scenario": "Custom client interface with a hidden file input or branded button.",
"prompt": "Use this skill to design a custom S3 upload interface with ClientS3Uploader. Include state handling, progress expectations, and error handling."
},
{
"title": "Add Server Uploads",
"scenario": "Server-side generation or processing before storage.",
"prompt": "Use this skill to outline a server-side S3 upload path for generated files. Include content type, object path, and response handling."
},
{
"title": "Harden Presigned Uploads",
"scenario": "Advanced review of security controls for production uploads.",
"prompt": "Use this skill to review a presigned S3 upload route. Identify missing authentication, authorization, validation, object ACL, and key naming controls."
}
],
"output_examples": [
{
"input": "Add a profile image uploader to my account settings page.",
"output": "The assistant recommends the button variant, lists the required route and callback, and notes where to store the returned image URL."
},
{
"input": "I need a project asset dropzone with five files and image-only uploads.",
"output": "The assistant describes the dropzone configuration, file limits, accepted image types, and expected upload completion behavior."
},
{
"input": "Review my presigned upload route before production.",
"output": "The assistant reports missing access checks, server-side validation needs, private object storage recommendations, and safer object key handling."
}
],
"best_practices": [
"Use least-privilege IAM permissions and deployment platform secrets for AWS access.",
"Validate file size, MIME type, extension, ownership, and object key prefix on the server.",
"Keep uploaded objects private by default and grant read access through signed URLs or controlled delivery."
],
"anti_patterns": [
"Do not expose long-lived AWS credentials in prompts, logs, code, or committed environment files.",
"Do not trust client-provided fileName, fileType, or upload path without server validation.",
"Do not use public-read uploads unless the product explicitly requires public objects."
],
"faq": [
{
"question": "Does this skill include the S3 uploader source code?",
"answer": "No. It provides implementation guidance and references to expected component and utility files."
},
{
"question": "Which upload patterns does it cover?",
"answer": "It covers a React UI component, a custom client uploader, and a server-side upload helper."
},
{
"question": "Can it help with presigned URLs?",
"answer": "Yes. It includes a presigned post route example using the AWS SDK."
},
{
"question": "Is the example production ready?",
"answer": "No. Production routes need authentication, authorization, validation, private object access, and safer key generation."
},
{
"question": "What tools can use this skill?",
"answer": "The report lists compatibility with Claude, Codex, and Claude Code."
},
{
"question": "What project style does it assume?",
"answer": "It assumes a TypeScript web app with React components and Next.js style API routes."
}
]
},
"file_structure": [
{
"name": "reference.md",
"type": "file",
"path": "reference.md",
"lines": 47
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 114
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |