filesystem
Safe file operations (read, write, list, search) with codebase awareness.
When & Why to Use This Skill
The Filesystem skill empowers Claude agents with robust and secure file I/O capabilities specifically optimized for codebase management. It enables seamless reading, writing, and directory navigation with built-in safety mechanisms like file backups and validation. By providing codebase awareness, this skill serves as a foundational tool for automated refactoring, documentation generation, and project structure analysis, ensuring all file operations adhere to professional development standards.
Use Cases
- Codebase Exploration: Automatically list directory contents and read source files to map out project architecture and understand complex dependencies.
- Automated Documentation: Generate and update README.md, API documentation, or change logs directly within the repository based on code analysis.
- Configuration Management: Programmatically create or modify environment variables, JSON configs, and YAML manifests with path validation to ensure system stability.
- Batch File Processing: Apply synchronized changes across multiple files simultaneously, such as updating headers, license information, or boilerplate code.
- Project Scaffolding: Initialize new project structures by creating necessary folders and template files while ensuring parent directory integrity.
| name | "filesystem" |
|---|---|
| version | "1.0.0" |
| description | "File I/O operations (read, write, list) for the codebase." |
| authors | ["omni-dev-fusion"] |
You have loaded the Filesystem Skill.
Scope: FILE I/O ONLY
This skill handles file reading and writing operations ONLY.
What to Use Instead
| Task | Use Skill | Tool |
|---|---|---|
| Text search in files | advanced_search | search_project_code (ripgrep) |
| Find files by pattern | filesystem | list_directory + path patterns |
| AST pattern search | code_navigation | search_code, search_directory |
| Code refactoring | structural_editing | structural_replace, structural_apply |
Available Tools
read_file: Read file content with line numberssave_file: Write file with backup and validationwrite_file: Simple file write (no backup)apply_file_changes: Batch write multiple fileslist_directory: List directory contentsget_file_info: Get file metadata
Important
- CRITICAL: When creating new files, always ensure the parent directory exists.
- CRITICAL: When editing code, always strictly follow the project's coding standards.
- CRITICAL: If you encounter a 'FileNotFoundError', check the path using
list_directory.