Official agent skill

S3 User Files

by aws-samples in aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore

Per-user persistent file storage backed by AWS S3. An agent skill from aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore.

OfficialMIT-0Auto-check passedBackend & APIs

Install S3 User Files

skills CLI

$ npx skills add aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore --skill s3-user-files -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore s3-user-files --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore.git skills-src && mkdir -p .claude/skills && cp -r skills-src/bridge/skills/s3-user-files .claude/skills/s3-user-files && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "s3-user-files" agent skill from https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore/tree/main/bridge/skills/s3-user-files into .claude/skills/s3-user-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "s3-user-files", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore/tree/main/bridge/skills/s3-user-files

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore --skill s3-user-files -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore s3-user-files --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore.git skills-src && mkdir -p .agents/skills && cp -r skills-src/bridge/skills/s3-user-files .agents/skills/s3-user-files && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "s3-user-files" agent skill from https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore/tree/main/bridge/skills/s3-user-files into .agents/skills/s3-user-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "s3-user-files", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore --skill s3-user-files -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore s3-user-files --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/bridge/skills/s3-user-files .cursor/skills/s3-user-files && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "s3-user-files" agent skill from https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore/tree/main/bridge/skills/s3-user-files into .cursor/skills/s3-user-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "s3-user-files", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore.git --path bridge/skills/s3-user-files

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore --skill s3-user-files -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore s3-user-files --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/bridge/skills/s3-user-files .gemini/skills/s3-user-files && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "s3-user-files" agent skill from https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore/tree/main/bridge/skills/s3-user-files into .gemini/skills/s3-user-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "s3-user-files", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore s3-user-files

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore --skill s3-user-files -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore.git skills-src && mkdir -p .github/skills && cp -r skills-src/bridge/skills/s3-user-files .github/skills/s3-user-files && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "s3-user-files" agent skill from https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore/tree/main/bridge/skills/s3-user-files into .github/skills/s3-user-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "s3-user-files", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore --skill s3-user-files -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore s3-user-files --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/bridge/skills/s3-user-files .opencode/skills/s3-user-files && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "s3-user-files" agent skill from https://github.com/aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore/tree/main/bridge/skills/s3-user-files into .opencode/skills/s3-user-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "s3-user-files", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: s3-user-files
GitHub stars: 177
Token cost: ~779 tokens
SKILL.md length: 330 words
Files: 9
Skills in repo: 5
Repo updated: Sep 28, 2026
First seen: Oct 7, 2026
Licence: MIT-0

At a glance

Per-user persistent file storage backed by AWS S3. An agent skill from aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore.

The user asks to save
SKILL.md covers Important, Usage, From Agent Chat and Security Notes
Runs JavaScript scripts from its folder; calls node and aws
Persist any information across sessions

What it does

S3 User Files is an agent skill from aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore, published by the product's own GitHub organization. Per-user persistent file storage backed by AWS S3. Read, write, list, and delete text files isolated per user. Each user has a private S3 namespace — no cross-user data leakage. Use when the user asks to save, remember, or persist any information across sessions.

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files (for example `common.js`, `common.test.js` and `delete.js`).

It sits in Backend & APIs, covering File uploads and storage. It works with Amazon S3. The licence is MIT-0.

When your agent uses it

The user asks to save
Persist any information across sessions

Example prompts

“/s3-user-files”

Requirements

Node.js
Pre-approved tools (allowed-tools): Bash(node:*)

What it can do on your machine

Read from SKILL.md and the folder at commit b0c427f. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Bash(node:*)
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships script files (JavaScript), which the agent can run.
Shell commands in SKILL.md call:
- node
- aws
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use aws, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

S3 User Files loads about 779 tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 330 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~69
When it runs · the whole SKILL.md, loaded when a task matches: ~779

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore at commit b0c427f, republished under its MIT-0 licence (© aws-samples). 330 words, ~779 tokens.

Download SKILL.mdSave it as .claude/skills/s3-user-files/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.

name: s3-user-files
description: Per-user persistent file storage backed by AWS S3. Read, write, list, and delete text files isolated per user. Each user has a private S3 namespace — no cross-user data leakage. Use when the user asks to save, remember, or persist any information across sessions.
allowed-tools: Bash(node:*)

S3 User Files

Per-user persistent file storage backed by AWS S3. Each user's files are stored in an isolated namespace — no cross-user data leakage.

Important

Always use the user_id from the system prompt when calling these tools. Never hardcode or guess a user_id. The system provides it automatically.

Usage

read_user_file

Read a file from the user's persistent storage.

bash

node {baseDir}/read.js <user_id> <filename>

user_id (required): The user's unique identifier (e.g., telegram_12345)
filename (required): The file name to read (e.g., IDENTITY.md)

write_user_file

Write content to a file in the user's persistent storage.

bash

node {baseDir}/write.js <user_id> <filename> <content>

user_id (required): The user's unique identifier
filename (required): The file name to write
content (required): The text content to write

list_user_files

List all files in the user's persistent storage.

bash

node {baseDir}/list.js <user_id>

user_id (required): The user's unique identifier

delete_user_file

Delete a file from the user's persistent storage.

bash

node {baseDir}/delete.js <user_id> <filename>

user_id (required): The user's unique identifier
filename (required): The file name to delete

presign_user_file

Generate a temporary download URL (presigned URL) for a file. The URL is valid for 1 hour by default.

bash

node {baseDir}/presign.js <user_id> <filename> [expires_in_seconds]

user_id (required): The user's unique identifier
filename (required): The file name to generate a URL for
expires_in_seconds (optional): URL validity in seconds (default: 3600, max: 604800)

Important: Always use this tool to generate presigned URLs. Do NOT use aws s3 presign CLI — it may produce SigV2 signatures that fail on KMS-encrypted buckets.

From Agent Chat

"Save my preferences" -> write_user_file with the user's preferences
"What do you remember about me?" -> read_user_file to check stored notes
"What's your name?" -> read_user_file IDENTITY.md for this user
"Forget everything about me" -> delete_user_file on each stored file
"What files do you have for me?" -> list_user_files
"Give me a download link for that file" -> presign_user_file
"Generate a presigned URL for my screenshot" -> presign_user_file

Security Notes

Files are isolated per user via S3 key prefix: {user_id}/{filename}
user_id uses underscores (e.g., telegram_12345) — colons are replaced
Content encrypted at rest via S3 server-side encryption
Bucket enforces SSL-only access
Path traversal attempts are sanitized (removes .., restricts characters)
Never use default_user as user_id — scripts reject it with an error

Files

SKILL.md and 8 other files in bridge/skills/s3-user-files of aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore.

SKILL.md
common.js
common.test.js
delete.js
list.js
package.json
presign.js
read.js
write.js

Open the folder on GitHubat commit b0c427f

Compare with similar skills

S3 User Files next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

S3 User Files compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
S3 User Files this skillaws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore	177	—	~779	Automated safety check: Pass	MIT-0	9 days ago
Processing S3 Uploads With Step Functionsaws/agent-toolkit-for-aws	2.8k	—	~4k	Automated safety check: Pass	Apache-2.0	today
Django Storages for S3Jeffallan/claude-skills	12k	—	~1.9k	Automated safety check: Pass	MIT	4 days ago
R2 Uploadzebbern/claude-code-guide	4.7k	1 repos	~886	Automated safety check: Pass	MIT	today
Neon Object Storageneondatabase/agent-skills	100	—	~3.5k	Automated safety check: Notes	Apache-2.0	yesterday
AWS S3majiayu000/claude-skill-registry	666	3 repos	~3.1k	Automated safety check: Pass	MIT	today

Similar skills

Processing S3 Uploads With Step Functions
aws/agent-toolkit-for-aws
Official
Deploy an event-driven workflow that routes S3 uploads to either Lambda or Fargate via Step Functions based on file size.
2.8k GitHub stars~4k tokensUpdated today
Backend & APIsAuto-check passed
Django Storages for S3
Jeffallan/claude-skills
Sets up Django 4.2+ to keep static and media files on AWS S3 through django-storages, with public and private backends, presigned URLs and CloudFront.
12k GitHub stars~1.9k tokensUpdated 4 days ago
Backend & APIsAuto-check passed
R2 Upload
zebbern/claude-code-guide
Upload files to Cloudflare R2, AWS S3, or any S3-compatible storage (like MinIO) and generate secure, time-limited presigned download links with configurable expiration, typically set to 5 minutes.
4.7k GitHub starsUsed in 1 repo~886 tokens
Backend & APIsAuto-check passed
Neon Object Storage
neondatabase/agent-skills
Official
S3-compatible object storage that branches with your Neon project, so files and the database stay in sync across every branch.
100 GitHub stars~3.5k tokensUpdated yesterday
Backend & APIsAuto-check: notes
AWS S3
majiayu000/claude-skill-registry
Configure S3 buckets, policies, and lifecycle rules. An agent skill from majiayu000/claude-skill-registry.
666 GitHub starsUsed in 3 repos~3.1k tokens
Backend & APIsAuto-check passed
S3
itsmostafa/aws-agent-skills
AWS S3 object storage for bucket management, object operations, and access control.
1.2k GitHub stars~2.3k tokensUpdated 2 days ago
Backend & APIsAuto-check passed

More from aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore

Agentcore Browser
aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore
Official
Browse web pages using a headless Chromium browser running inside the AgentCore container.
177 GitHub stars~688 tokensUpdated 9 days ago
Auto-check passed
Clawhub Manage
aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore
Official
Install, uninstall, and list ClawHub community skills. An agent skill from aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore.
177 GitHub stars~593 tokensUpdated 9 days ago
Auto-check passed
Eventbridge Cron
aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore
Official
Schedule recurring tasks using Amazon EventBridge Scheduler.
177 GitHub stars~1.1k tokensUpdated 9 days ago
Auto-check passed
API Keys
aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore
Official
Dual-mode API key storage — native file-based or AWS Secrets Manager.
177 GitHub stars~825 tokensUpdated 9 days ago
Auto-check passed

Works with

Amazon S3

Questions about S3 User Files

What does S3 User Files do?

Per-user persistent file storage backed by AWS S3. An agent skill from aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore. S3 User Files is an agent skill from aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore, published by the product's own GitHub organization. Per-user persistent file storage backed by AWS S3.

When should I use S3 User Files?

S3 User Files fits situations like: the user asks to save; persist any information across sessions.

How do I install S3 User Files in Claude Code?

Run `npx skills add aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore --skill s3-user-files -a claude-code`. Or copy the skill folder (bridge/skills/s3-user-files in aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore) into .claude/skills/s3-user-files in your project. Claude Code loads it when a task matches its description.

How do I install S3 User Files in Codex?

Run `npx skills add aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore --skill s3-user-files -a codex`. Or copy the skill folder (bridge/skills/s3-user-files in aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore) into .agents/skills/s3-user-files in your project. Codex loads it when a task matches its description.

Can I use S3 User Files in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore --skill s3-user-files -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/s3-user-files, .gemini/skills/s3-user-files, .github/skills/s3-user-files and .opencode/skills/s3-user-files in your project.

What does S3 User Files need to run?

Going by SKILL.md and its folder, S3 User Files needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node and aws). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Bash(node:*).

Does S3 User Files access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is S3 User Files safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does S3 User Files use?

S3 User Files is published under the MIT-0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does S3 User Files use?

About 779 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to S3 User Files?

Skills that share tags, products or a category with S3 User Files: Processing S3 Uploads With Step Functions (aws/agent-toolkit-for-aws, 2.8k stars), Django Storages for S3 (Jeffallan/claude-skills, 12k stars), R2 Upload (zebbern/claude-code-guide, 4.7k stars) and Neon Object Storage (neondatabase/agent-skills, 100 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains S3 User Files?

aws-samples (a GitHub organization, an official publisher) maintains it in aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore, which has 177 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 28, 2026.

Source: aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install S3 User Files

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

S3 User Files

Important

Usage

read_user_file

write_user_file

list_user_files

delete_user_file

presign_user_file

From Agent Chat

Security Notes

Files

Compare with similar skills

Similar skills

More from aws-samples/sample-host-openclaw-on-amazon-bedrock-agentcore

Related

Questions about S3 User Files