---
name: workspace
description: Read, write, and list files in the workspace. Use for file operations, code editing, and project navigation.
---

# Workspace Skill

Use this skill when you need to:
- Read file contents
- Write or update files
- List files in directories
- Navigate the project structure

## Tools

- **read_file**: Read the contents of a file by path.
- **write_file**: Write content to a file (creates or overwrites).
- **list_files**: List files in a directory with optional pattern matching.

## Usage Pattern

1. Use `workspace.list_files` to explore the project structure
2. Use `workspace.read_file` to examine file contents
3. Use `workspace.write_file` to create or modify files

## Tips

- Always read a file before modifying it to understand the context
- Use relative paths from the workspace root
- Check if a file exists before trying to read it
