---

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

1. Read:

   read_file(path)

   • Example:

     python3 ... read docs/intro.md

2. Write:

   write_file(path, content)

   • Example:

     python3 ... write docs/intro.md "# Hello"

   • Note: Automatically creates parent directories (

     mkdir -p

     ).
3. List:

   list_directory(path)

   • Example:

     python3 ... list src/

4. Check:

   check_exists(path)

   • Example:

     python3 ... exists config.json

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.