xiaoli-cli/skills/file-manager/SKILL.md

name, description, license, version, author, tools

name	description	license	version	author	tools
file-manager	File and directory management tool for creating, reading, writing, deleting, moving, copying, and searching files. Use this skill when the user needs to perform file operations, list directories, search by pattern or content, or get file metadata like size and modification time.	MIT	1.0.0	Xiaoli Team (based on openakita/openakita)	read_file write_file bash

File Manager Skill

A comprehensive file and directory management toolset for AI agents.

Capabilities

• Create: Files and directories
• Read: File contents with encoding support
• Write: Create or overwrite files
• Append: Add content to existing files
• Delete: Remove files or directories
• Move: Move or rename files and directories
• Copy: Duplicate files or directories
• Search: Find files by pattern or content
• List: Browse directory contents
• Info: Get file metadata (size, dates, permissions)

Script Usage

This skill includes a Python script for structured JSON output:

python scripts/file_ops.py list <path> [--recursive] [--pattern "*.py"]
python scripts/file_ops.py read <file_path> [--encoding utf-8] [--lines N]
python scripts/file_ops.py write <file_path> --content "内容" [--append]
python scripts/file_ops.py copy <source> <destination>
python scripts/file_ops.py move <source> <destination>
python scripts/file_ops.py delete <path> [--recursive]
python scripts/file_ops.py search <directory> --pattern "*.py" [--content "搜索词"]
python scripts/file_ops.py info <path>

Direct Shell Commands

List Directory Contents

When asked to show files in a directory:

# List current directory
ls -la

# List specific directory
ls -la /path/to/directory

# Recursive listing (Unix)
find /path -type f -name "*.py"

# Windows
dir /s /b C:\path\*.py

Read File

When asked to read a file:

# Read entire file
cat filename.txt

# Read with line numbers
cat -n filename.txt

# Read first N lines
head -n 50 filename.txt

# Read last N lines
tail -n 50 filename.txt

Write File

When asked to create or write a file:

# Write content to file (overwrites)
echo "content" > filename.txt

# Write multiple lines
cat > filename.txt << 'EOF'
Line 1
Line 2
Line 3
EOF

# Windows PowerShell
Set-Content -Path filename.txt -Value "content"

Append to File

When asked to add content to an existing file:

# Append to file
echo "new line" >> filename.txt

# Append multiple lines
cat >> filename.txt << 'EOF'
Additional line 1
Additional line 2
EOF

Create Directory

When asked to create a folder:

# Create single directory
mkdir directory_name

# Create nested directories
mkdir -p path/to/nested/directories

# Windows
mkdir path\to\nested\directories

Delete File or Directory

When asked to delete:

# Delete a file
rm filename.txt

# Delete empty directory
rmdir directory_name

# Delete directory and contents
rm -rf directory_name

# Windows
del filename.txt
rmdir /s /q directory_name

⚠️ Warning: Deletion is permanent. Always confirm before deleting.

Copy File or Directory

When asked to copy:

# Copy file
cp source.txt destination.txt

# Copy directory recursively
cp -r source_dir/ destination_dir/

# Windows
copy source.txt destination.txt
xcopy /E /I source_dir destination_dir

Move or Rename

When asked to move or rename:

# Move file
mv source.txt /new/location/source.txt

# Rename file
mv oldname.txt newname.txt

# Windows
move source.txt destination.txt
ren oldname.txt newname.txt

Search Files

When asked to find files:

# Find by name pattern
find /path -name "*.py"
find /path -iname "*.PY"  # case-insensitive

# Find by content (grep)
grep -r "search_term" /path
grep -rl "search_term" /path  # filenames only

# Windows PowerShell
Get-ChildItem -Path C:\path -Filter *.py -Recurse
Select-String -Path C:\path\*.py -Pattern "search_term"

Get File Information

When asked about file details:

# File metadata (Unix)
ls -la filename.txt
stat filename.txt

# File size only
du -h filename.txt

# Windows
dir filename.txt

JSON Output Format

All operations should return structured results:

{
  "success": true,
  "operation": "list",
  "path": "/home/user/project",
  "data": {
    "files": ["main.py", "config.json", "README.md"],
    "directories": ["src", "tests", "docs"],
    "total_count": 6
  },
  "timestamp": "2026-03-21T10:30:00Z"
}

Safety Rules

1. Always validate paths: Reject paths containing .. that escape the working directory
2. Confirm destructive operations: Ask before delete, move, or overwrite
3. Handle encoding: Default to UTF-8, detect and handle other encodings
4. Large file warning: Alert for files > 10MB
5. Binary file detection: Cannot read binary files as text

Protected Directories

Never allow operations on:

• System directories: /etc, /root, C:\Windows, C:\Program Files
• Hidden files starting with . (unless explicitly requested)
• Files with sensitive names: .env, credentials, secrets

Error Handling

Error	Response
File not found	Suggest similar filenames or check path
Permission denied	Explain required permissions
Disk full	Warn user and suggest cleanup
Invalid path	Show correct path format

Examples

Example 1: List Project Files

User: "Show me the project structure"

find . -type f -name "*.py" | head -20
tree -L 2 -I '__pycache__|*.pyc'

Example 2: Search and Replace

User: "Replace 'old_func' with 'new_func' in all Python files"

# Find and preview
grep -r "old_func" --include="*.py" .

# Replace (with backup)
find . -name "*.py" -exec sed -i.bak 's/old_func/new_func/g' {} \;

Example 3: Safe Delete

User: "Delete the temp folder"

Before executing:

1. Check if path exists
2. List contents to show what will be deleted
3. Ask for confirmation
4. Execute if confirmed

Cross-Platform Notes

Operation	Unix	Windows
List	ls -la	dir
Copy	cp	copy
Move	mv	move
Delete	rm -rf	rmdir /s /q
Find	find	Get-ChildItem
Grep	grep	Select-String

Always detect the OS and use appropriate commands.