← Back to Skills Marketplace
srikanth-hn

Doctor Nexus Filesystem

by Srikanth · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
426
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install doctor-nexus-filesystem
Description
Perform advanced filesystem tasks including recursive listing, name/content searching, batch copying/moving/deleting, and directory size and type analysis.
README (SKILL.md)

Filesystem Operations

文件系统操作工具,提供目录列表、内容搜索、批量处理和目录分析功能。

快速开始

列出目录

# 列出当前目录
ls -la

# 递归列出目录树
find . -type f -name "*.md" | head -20

# 按类型过滤
find . -type f \( -name "*.md" -o -name "*.txt" \)

搜索文件

# 按名称搜索
find . -name "*keyword*"

# 按内容搜索
grep -r "keyword" . --include="*.md"

# 不区分大小写搜索
grep -ri "keyword" . --include="*.md"

分析目录

# 统计文件类型
find . -type f -name "*.md" | wc -l

# 查看目录大小
du -sh .

# 找出最大文件
find . -type f -exec ls -lh {} \; | sort -k5 -h | head -10

核心功能

1. 目录列表

基础列表

ls -la                    # 详细列表
ls -lh                    # 人类可读大小
ls -lt                    # 按修改时间排序
ls -R                     # 递归列表

高级列表

# 列出特定类型
find . -type f -name "*.md"

# 按深度列出
find . -maxdepth 2 -type f

# 排除特定目录
find . -type f -not -path "*/node_modules/*"

2. 文件搜索

按名称搜索

# 精确匹配
find . -name "filename.md"

# 模式匹配
find . -name "*pattern*"

# 大小写不敏感
find . -iname "*pattern*"

按内容搜索

# 基础搜索
grep -r "keyword" .

# 包含行号
grep -rn "keyword" .

# 只搜索特定文件
grep -r "keyword" . --include="*.md"

# 排除目录
grep -r "keyword" . --exclude-dir=node_modules

正则表达式搜索

# 使用正则
grep -r "^## " . --include="*.md"

# 多个关键词
grep -r "key1\|key2" .

# 行首/行尾
grep -r "^关键词" .
grep -r "关键词$" .

3. 批量操作

批量复制

# 复制特定类型
find . -name "*.md" -exec cp {} backup/ \;

# 复制到多个位置
for file in *.md; do cp "$file" dir1/ && cp "$file" dir2/; done

批量移动

# 移动特定文件
find . -name "*.log" -exec mv {} logs/ \;

# 按条件移动
find . -type f -size +1M -exec mv {} large/ \;

批量删除

# 删除特定类型
find . -name "*.tmp" -delete

# 删除空目录
find . -type d -empty -delete

# 删除旧文件
find . -type f -mtime +30 -delete

批量重命名

# 使用 rename 命令
rename 's/old/new/' *.md

# 添加前缀
for file in *.md; do mv "$file" "prefix_$file"; done

4. 目录分析

大小分析

# 总大小
du -sh .

# 各目录大小
du -h --max-depth=1 . | sort -hr

# 最大的文件
find . -type f -exec ls -lh {} \; | sort -k5 -hr | head -10

文件类型统计

# 按扩展名统计
find . -type f -name "*.md" | wc -l

# 各类型统计
find . -type f -name "*.*" | sed 's/.*\.//' | sort | uniq -c

目录结构分析

# 目录树
tree -L 2

# 递归深度
find . -type d | wc -l

# 文件分布
find . -type f | cut -d/ -f1-2 | sort | uniq -c

5. 文件信息查询

文件详情

# 完整信息
stat filename

# 只看大小
ls -lh filename

# 只看时间
ls -lt filename

文件内容预览

# 头部
head -20 filename

# 尾部
tail -20 filename

# 随机行
shuf -n 10 filename

# 字符数
wc -c filename

# 行数
wc -l filename

实用工具

tree 命令

# 安装
brew install tree

# 使用
tree -L 2 -I 'node_modules|__pycache__'

fd 命令(快速查找)

# 安装
brew install fd

# 使用
fd "pattern" /path
fd -e md .    # 只找 md 文件
fd -t f .       # 只找文件

ripgrep 命令(快速搜索)

# 安装
brew install ripgrep

# 使用
rg "keyword" .
rg -t md "keyword" .
rg -i "keyword" .          # 不区分大小写
rg --type md "pattern" .

最佳实践

1. 搜索优化

  • 使用 fdripgrep 替代 findgrep(更快)
  • 先缩小搜索范围,再进行深度搜索
  • 使用文件类型过滤减少搜索时间

2. 批量操作安全

  • 操作前先用 --dry-run 查看会发生什么
  • 批量删除前先列出文件确认
  • 重要操作前先备份

3. 目录分析

  • 使用 -max-depth 限制递归深度
  • 使用 -size 过滤大文件
  • 使用 -mtime 按时间筛选

常见任务

查找并处理 Markdown 文件

# 查找所有 md 文件
find . -name "*.md" -type f

# 统计 md 文件数量
find . -name "*.md" | wc -l

# 列出最大的 md 文件
find . -name "*.md" -exec ls -lh {} \; | sort -k5 -hr | head -5

搜索并替换内容

# 搜索所有匹配项
grep -rn "old_text" . --include="*.md"

# 替换(使用 sed)
find . -name "*.md" -exec sed -i '' 's/old_text/new_text/g' {} \;

清理临时文件

# 删除 .tmp 文件
find . -name "*.tmp" -delete

# 删除空目录
find . -type d -empty -delete

# 删除 30 天前的日志
find . -name "*.log" -mtime +30 -delete

安全提醒

⚠️ 批量操作前先确认

  • 列出要操作的文件
  • 确认不会误删重要文件
  • 考虑先备份

⚠️ 删除操作不可逆

  • rm 删除后无法恢复
  • 大批量删除前仔细检查
  • 考虑使用 rm -i 交互式删除

⚠️ 权限注意

  • 某些操作可能需要 sudo
  • 系统目录操作要谨慎
  • 考虑文件权限问题
Usage Guidance
This skill is coherent with its description and contains useful shell examples for filesystem tasks, but many commands are destructive (bulk delete, move, sed replacements, use of sudo). Before letting an agent execute these: (1) review the exact command lines the agent will run; (2) test on a safe sample directory first; (3) list (--dry-run / plain find output) before running delete/mv operations and keep backups; (4) be aware some examples assume macOS (sed -i '' and brew); (5) the skill requests no credentials and performs no network calls, but if you allow autonomous agent execution ensure the agent is restricted or supervised because it could run destructive commands on your files.
Capability Analysis
Type: OpenClaw Skill Name: doctor-nexus-filesystem Version: 1.0.0 The skill bundle 'doctor-nexus-filesystem' provides instructions for an AI agent to perform extensive filesystem operations using powerful shell commands such as 'find', 'sed', and 'rm' in SKILL.md. While these capabilities are clearly aligned with the stated purpose of a filesystem management tool and include safety warnings (e.g., dry-run suggestions), the broad shell-based file access and the inclusion of destructive commands like recursive deletion ('find -delete') and in-place modification ('sed -i') constitute high-risk behaviors according to the analysis criteria. No evidence of intentional malice, data exfiltration, or obfuscation was found.
Capability Assessment
Purpose & Capability
Name and description match the SKILL.md contents: the document provides commands for recursive listing, searching, batch copy/move/delete, and analysis. Nothing in the files requests unrelated credentials, binaries, or network access.
Instruction Scope
The instructions include destructive operations (find ... -delete, mv, cp, sed -i, rm) and mention use of sudo for privileged operations — this is appropriate for a filesystem tool but requires user caution. The SKILL.md does not instruct reading unrelated files or environment variables, nor does it reference external endpoints. Minor portability note: examples use sed -i '' (BSD/macOS style) and brew for installs, so some commands may behave differently on non-macOS systems.
Install Mechanism
There is no install spec and no code shipped — the skill is instruction-only. No downloads or archive extraction are performed.
Credentials
The skill does not request any environment variables, credentials, or config paths. All commands operate on local filesystem and the declared requirements match the content.
Persistence & Privilege
always is false and the skill does not attempt to modify other skills or system configuration. It does note operations that may require sudo, which is expected for filesystem tasks and does not imply extra privileges requested by the skill itself.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install doctor-nexus-filesystem
  3. After installation, invoke the skill by name or use /doctor-nexus-filesystem
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the filesystem skill with comprehensive documentation. - Advanced filesystem operations: list, search, batch process, and analyze directories/files. - Supports recursive search, file type filtering, size analysis, and batch operations (copy/move/delete). - Includes practical bash command examples and best practices. - Features both Chinese and English documentation. - Safety reminders and tool recommendations (fd, ripgrep, tree) provided.
Metadata
Slug doctor-nexus-filesystem
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Doctor Nexus Filesystem?

Perform advanced filesystem tasks including recursive listing, name/content searching, batch copying/moving/deleting, and directory size and type analysis. It is an AI Agent Skill for Claude Code / OpenClaw, with 426 downloads so far.

How do I install Doctor Nexus Filesystem?

Run "/install doctor-nexus-filesystem" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Doctor Nexus Filesystem free?

Yes, Doctor Nexus Filesystem is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Doctor Nexus Filesystem support?

Doctor Nexus Filesystem is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Doctor Nexus Filesystem?

It is built and maintained by Srikanth (@srikanth-hn); the current version is v1.0.0.

💬 Comments