workspace

Read and write session workspace files with logical paths and encodings.

186|56|Updated Aug 13, 2025
One-click install
npx skills add https://github.com/aws-samples/sample-strands-agent-with-agentcore --skill workspace-aws-samples
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace
Source: https://github.com/aws-samples/sample-strands-agent-with-agentcore/tree/main/chatbot-app/agentcore/skills/workspace
Command: npx skills add https://github.com/aws-samples/sample-strands-agent-with-agentcore --skill workspace-aws-samples

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a single, consistent way for agents and skills to read and write files within an isolated session workspace, eliminating ad hoc file passing and reducing friction when sharing artifacts across tools and agents. It centralizes access to code agent outputs, interpreter results, documents, images, and other artifacts while handling encoding and availability concerns.

Core Features & Use Cases

  • Unified read/write access using logical path namespaces so agents can find files created by other skills.
  • Encoding-aware transfers that return text for plain files and base64 for binary files, and accept base64 when writing binaries.
  • Immediate cross-skill availability enabling workflows like: a code agent saves a report and an analysis agent reads it, or export a spreadsheet created by one skill for consumption by another.

Quick Start

Read the file code-agent/report.md and return its text content.

Frequently Asked Questions about workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read and write session files across multiple agents?

To read and write session files across multiple agents, use a unified workspace that provides logical path namespaces. This allows agents to find files created by other skills and immediately access shared artifacts like code outputs and documents.

How does cross-skill file sharing work for binary images and documents?

Cross-skill file sharing for binary images and documents works through encoding-aware transfers. The workspace automatically returns text for plain files and base64 for binary files, and accepts base64 encoding when writing binaries to ensure data integrity.

Can I use logical path namespaces to exchange interpreter results between tools?

Yes, you can use logical path namespaces to exchange interpreter results between tools. This unified read and write access centralizes artifact sharing, allowing a code agent to save a report and an analysis agent to read it immediately.

What's the best way to isolate session file access for specific users?

The best way to isolate session file access is to use a workspace that provides automatic userId and sessionId injection. This mechanism ensures isolated session access, preventing cross-contamination of artifacts between different users and sessions.

Why do I need a unified file workspace for multi-agent workflows?

You need a unified file workspace for multi-agent workflows to eliminate ad hoc file passing and reduce friction. It centralizes access to artifacts like code agent outputs and office documents while handling text and base64 encoding automatically.