majiayu000 name: file-manager description: Reads, writes, and manages files and directories using a secure Python script. version: 1.1.0 operations: read_file: side_effects: none write_file: side_effects: constructive delete_file: side_effects: destructive requires_human_approval: true
File Manager Skill
1. Objective
To provide agents with the ability to persistent store and retrieve information in the filesystem safely.
2. Input
operation: 'read', 'write', 'list', 'exists'.path: Relative path from project root.content: (For write) String content.
3. Process
This skill delegates strict permissions to a Python script.
Command Structure
python3 .agent/skills/file-manager/src/file_ops.py [operation] [path] "[content]"
Operations
- Read:
read_file(path)- Example:
python3 ... read docs/intro.md
- Example:
- Write:
write_file(path, content)- Example:
python3 ... write docs/intro.md "# Hello" - Note: Automatically creates parent directories (
mkdir -p).
- Example:
- List:
list_directory(path)- Example:
python3 ... list src/
- Example:
- Check:
check_exists(path)- Example:
python3 ... exists config.json
- Example:
4. Output
JSON Object containing result or error.
{
"success": true,
"content": "..."
}
5. Security
- Sandbox: Operations are strictly limited to the Current Working Directory (CWD).
- Rejection: Paths containing
../that traverse outside CWD will raise a Security Error.