Filesystem

Filesystem Skill

Overview

Direct filesystem operations without external dependencies. Read, write, edit, list, copy, move, and search files.

Usage

Use the available builtin tools to perform file operations directly. Commonly used tools for this skill are: list_dir, read_file, file_create, edit_file_by_lines, grep, and bash.

When the task requires programmatic/structured processing (e.g., parsing complex formats or batch transformations), python_repl can be used as an advanced fallback.

• Paths can be absolute or relative to working_dir
• Parent directories are created automatically for write operations
• For complex file operations not covered by builtin tools, use bash

Common Recipes

JSON

pythonCopy code
import json

# Read
with open('data.json', 'r', encoding='utf-8') as f:
    data = json.load(f)

# Write (pretty-printed)
with open('output.json', 'w', encoding='utf-8') as f:
    json.dump(data, f, indent=2, ensure_ascii=False)

CSV

pythonCopy code
import csv

# Read
with open('data.csv', 'r', encoding='utf-8') as f:
    reader = csv.DictReader(f)
    for row in reader:
        print(row)

# Write
with open('output.csv', 'w', newline='', encoding='utf-8') as f:
    writer = csv.DictWriter(f, fieldnames=['name', 'value'])
    writer.writeheader()
    writer.writerows([{'name': 'a', 'value': 1}])

YAML

pythonCopy code
# Requires: pip install pyyaml
import yaml

# Read
with open('config.yaml', 'r') as f:
    data = yaml.safe_load(f)

# Write
with open('output.yaml', 'w') as f:
    yaml.dump(data, f, default_flow_style=False, allow_unicode=True)

Directory Operations

bashCopy code
# List files recursively
find . -type f -name "*.py"

# Directory size
du -sh /path/to/dir

# Copy directory
cp -r src/ dst/

# Move/rename
mv old_name.txt new_name.txt

File Search

bashCopy code
# Search file contents (grep)
grep -r "search_term" --include="*.py" .

# Find files by name
find . -name "*.log" -mtime -7  # Modified in last 7 days

# Count lines
wc -l *.py

Text Processing

bashCopy code
# Sort and deduplicate
sort file.txt | uniq > sorted.txt

# Extract columns
cut -d',' -f1,3 data.csv

# Replace text
sed -i '' 's/old/new/g' file.txt  # macOS
sed -i 's/old/new/g' file.txt     # Linux