File Manager
Let your agent safely create, move, rename, and batch-organize project and download folders with previews before destructive actions.
Overview
File Manager is an agent skill most often used in Build (also Operate, Validate) that performs guarded file and folder operations with previews before batch or destructive changes.
Install
npx skills add https://github.com/rtgs2017/nagaagent --skill file-managerWhat is this skill?
- Covers create/copy/move/rename/delete for files and recursive folder operations.
- Batch flows: classify by type, bulk rename, find duplicates, tidy Downloads-style folders.
- Safety gates: blocks system paths, requires confirmation before delete and overwrite, previews batch impact.
- Documents preview-then-confirm output format with moved/skipped/error counts after execution.
- 3 core capability areas: file ops, folder ops, batch processing
- 3 safety categories: forbidden paths, confirmation-required actions, preview-before-batch
Adoption & trust: 601 installs on skills.sh; 1.5k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your downloads or project directories are chaotic and you want an agent to reorganize files without silently deleting system paths or overwriting work.
Who is it for?
Solo builders who delegate local folder cleanup and batch renaming to an agent under explicit confirmation rules.
Skip if: Production server file management, multi-user permission systems, or workflows that must run fully unattended deletes without review.
When should I use this skill?
用户需要管理文件、整理文件夹或批量处理文件时（when users need file management, folder organization, or batch file processing).
What do I get? / Deliverables
You get previewed move/rename/delete plans, confirmed execution, and a summarized result count of moved, skipped, and failed items.
- Preview of pending file operations
- Post-run summary with moved, skipped, and error counts
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
File and folder hygiene is shelved under Build → pm because solo builders most often invoke it while structuring repos, assets, and local workspaces—not as a launch or growth tactic. Pm subphase covers workspace organization, batch file ops, and keeping a shippable tree tidy alongside feature work.
Where it fits
Sort design exports and PDF specs into typed subfolders before opening a implementation plan.
Rename scattered prototype screenshots to a consistent pattern for stakeholder review.
Archive old log bundles and clear a bloated Downloads directory after a release.
How it compares
Agent workflow skill with safety prompts—not a GUI file manager app or git-based refactor tool.
Common Questions / FAQ
Who is file-manager for?
Indie builders using Naga-style agents who need structured local file ops with Chinese or bilingual instructions and strict pre-delete previews.
When should I use file-manager?
In Build when structuring project folders; in Validate when organizing prototype assets; in Operate when cleaning exports—whenever the user asks to manage, move, or batch-process files.
Is file-manager safe to install?
The skill encodes guardrails but agents can still misuse shell access; review the Security Audits panel on this page and keep deletes behind explicit user confirmation.
SKILL.md
READMESKILL.md - File Manager
# 文件管理技能 本技能提供文件和文件夹管理能力。 ## 核心功能 ### 1. 文件操作 - 创建文件 - 复制/移动文件 - 重命名文件 - 删除文件 ### 2. 文件夹操作 - 创建文件夹 - 列出目录内容 - 删除文件夹（递归） - 复制文件夹 ### 3. 批量处理 - 按类型分类 - 批量重命名 - 查找重复文件 - 整理下载文件夹 ## 安全规则 ### 禁止操作 - 系统目录（/System, /usr, /bin 等） - 其他用户的文件 - 没有明确确认的删除操作 ### 需要确认 - 删除文件前列出将被删除的内容 - 覆盖已存在的文件前提醒 - 批量操作前显示预览 ## 常用操作示例 ### 整理下载文件夹 ```bash # 1. 创建分类目录 mkdir -p ~/Downloads/{Documents,Images,Videos,Archives,Others} # 2. 按扩展名移动 mv ~/Downloads/*.pdf ~/Downloads/Documents/ mv ~/Downloads/*.{jpg,png,gif} ~/Downloads/Images/ mv ~/Downloads/*.{mp4,mov,avi} ~/Downloads/Videos/ mv ~/Downloads/*.{zip,rar,7z} ~/Downloads/Archives/ ``` ### 批量重命名 ```python import os from pathlib import Path def batch_rename(directory, pattern, replacement): for file in Path(directory).iterdir(): if pattern in file.name: new_name = file.name.replace(pattern, replacement) file.rename(file.parent / new_name) ``` ## 输出格式 操作前显示预览： ``` 即将执行以下操作： - 移动 15 个 PDF 文件到 Documents/ - 移动 23 个图片文件到 Images/ - 跳过 3 个未知类型文件 确认执行？ ``` 操作后显示结果： ``` ✓ 操作完成 - 移动: 38 个文件 - 跳过: 3 个文件 - 错误: 0 个 ```