# F8 Tools Io Filesystem Workflow

> F8 Tools Io Filesystem Workflow is an Agent Skill for development published in the TippingGame/F8Framework repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when working with IO/FileSystem tools — file read/write, directory operations, and path utilities in F8Framework.

- Skill name: `f8-tools-io-filesystem-workflow`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/TippingGame/F8Framework/blob/HEAD/Tests/AISkills/f8framework-skills/tools/f8-tools-io-filesystem-workflow/SKILL.md
- Repository: TippingGame/F8Framework (866 GitHub stars when collected)

## SKILL.md

# IO/FileSystem Tools Workflow



## Use this skill when

- The task involves file I/O, directory management, or path manipulation.
- The user needs to read/write files, copy/move/delete, or manage directories.

## Path resolution

1. Source: Assets/F8Framework/Runtime/Utility/IO.cs (~35KB)

## Sources of truth

- Source file: Assets/F8Framework/Runtime/Utility/IO.cs

## Key capabilities

- File read/write (text, bytes, streams)
- Directory creation, deletion, enumeration
- File copy, move, rename
- Path manipulation and normalization
- File existence checking
- File size and metadata queries
- Platform-specific path handling
- Recursive directory operations

## Workflow

1. Use `Util.IO` or `FileTools` class (check actual class name in source).
2. All methods are static — no initialization needed.
3. Handle platform differences: use `Application.persistentDataPath` for writable paths.
4. Be careful with StreamingAssets on Android (read-only, in APK).

## Common error handling

| Error | Cause | Solution |
|-------|-------|----------|
| File write fails | Path not writable | Use `Application.persistentDataPath` |
| StreamingAssets read fails on Android | Files inside APK | Use `SyncStreamingAssetsLoader` |
| Path separator issues | Windows vs Unix paths | Use `Path.Combine()` and normalize |

## Output checklist

- File operation type identified.
- Platform-appropriate paths used.
- Error handling for I/O exceptions.

---

Source: https://www.openparable.com/skill/development/f8-tools-io-filesystem-workflow (OpenParable). Cite the canonical URL above.
