AGENT SKILL

filesystem

Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot

License 许可
MIT
最近更新
2026-05-17
Stars
★ 0
Forks
0

01 前言 Front Matter

name
filesystem
homepage
https://github.com/gtrusler/clawdbot-filesystem
metadata
{ "clawdbot": { "emoji": "📁", "requires": { "bins": [ "node" ] } } }
description
Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot

02 资源文件 5

03 SKILL.md 正文

📁 Filesystem Management

Advanced filesystem operations for AI agents. Comprehensive file and directory operations with intelligent filtering, searching, and batch processing capabilities.

Features

📋 Smart File Listing

  • Advanced Filtering - Filter by file types, patterns, size, and date
  • Recursive Traversal - Deep directory scanning with depth control
  • Rich Formatting - Table, tree, and JSON output formats
  • Sort Options - By name, size, date, or type

🔍 Powerful Search

  • Pattern Matching - Glob patterns and regex support
  • Content Search - Full-text search within files
  • Multi-criteria - Combine filename and content searches
  • Context Display - Show matching lines with context

🔄 Batch Operations

  • Safe Copying - Pattern-based file copying with validation
  • Dry Run Mode - Preview operations before execution
  • Progress Tracking - Real-time operation progress
  • Error Handling - Graceful failure recovery

🌳 Directory Analysis

  • Tree Visualization - ASCII tree structure display
  • Statistics - File counts, size distribution, type analysis
  • Space Analysis - Identify large files and directories
  • Performance Metrics - Operation timing and optimization

Quick Start

# List files with filtering
filesystem list --path ./src --recursive --filter "*.js"

# Search for content
filesystem search --pattern "TODO" --path ./src --content

# Batch copy with safety
filesystem copy --pattern "*.log" --to ./backup/ --dry-run

# Show directory tree
filesystem tree --path ./ --depth 3

# Analyze directory structure
filesystem analyze --path ./logs --stats

Command Reference

filesystem list

Advanced file and directory listing with filtering options.

Options:

  • --path, -p <dir> - Target directory (default: current)
  • --recursive, -r - Include subdirectories
  • --filter, -f <pattern> - Filter files by pattern
  • --details, -d - Show detailed information
  • --sort, -s <field> - Sort by name|size|date
  • --format <type> - Output format: table|json|list

filesystem search

Search files by name patterns or content.

Options:

  • --pattern <pattern> - Search pattern (glob or regex)
  • --path, -p <dir> - Search directory
  • --content, -c - Search file contents
  • --context <lines> - Show context lines
  • --include <pattern> - Include file patterns
  • --exclude <pattern> - Exclude file patterns

filesystem copy

Batch copy files with pattern matching and safety checks.

Options:

  • --pattern <glob> - Source file pattern
  • --to <dir> - Destination directory
  • --dry-run - Preview without executing
  • --overwrite - Allow file overwrites
  • --preserve - Preserve timestamps and permissions

filesystem tree

Display directory structure as a tree.

Options:

  • --path, -p <dir> - Root directory
  • --depth, -d <num> - Maximum depth
  • --dirs-only - Show directories only
  • --size - Include file sizes
  • --no-color - Disable colored output

filesystem analyze

Analyze directory structure and generate statistics.

Options:

  • --path, -p <dir> - Target directory
  • --stats - Show detailed statistics
  • --types - Analyze file types
  • --sizes - Show size distribution
  • --largest <num> - Show N largest files

Installation

# Clone or install the skill
cd ~/.clawdbot/skills
git clone <filesystem-skill-repo>

# Or install via ClawdHub
clawdhub install filesystem

# Make executable
chmod +x filesystem/filesystem

Configuration

Customize behavior via config.json:

{
  "defaultPath": "./",
  "maxDepth": 10,
  "defaultFilters": ["*"],
  "excludePatterns": ["node_modules", ".git", ".DS_Store"],
  "outputFormat": "table",
  "dateFormat": "YYYY-MM-DD HH:mm:ss",
  "sizeFormat": "human",
  "colorOutput": true
}

Examples

Development Workflow

# Find all JavaScript files in src
filesystem list --path ./src --recursive --filter "*.js" --details

# Search for TODO comments
filesystem search --pattern "TODO|FIXME" --path ./src --content --context 2

# Copy all logs to backup
filesystem copy --pattern "*.log" --to ./backup/logs/ --preserve

# Analyze project structure
filesystem tree --path ./ --depth 2 --size

System Administration

# Find large files
filesystem analyze --path /var/log --sizes --largest 10

# List recent files
filesystem list --path /tmp --sort date --details

# Clean old temp files
filesystem list --path /tmp --filter "*.tmp" --older-than 7d

Safety Features

  • Path Validation - Prevents directory traversal attacks
  • Permission Checks - Verifies read/write access before operations
  • Dry Run Mode - Preview destructive operations
  • Backup Prompts - Suggests backups before overwrites
  • Error Recovery - Graceful handling of permission errors

Integration

Works seamlessly with other Clawdbot tools:

  • Security Skill - Validates all filesystem operations
  • Git Operations - Respects .gitignore patterns
  • Backup Tools - Integrates with backup workflows
  • Log Analysis - Perfect for log file management

Updates & Community

Stay informed about the latest Clawdbot skills and filesystem tools:

  • 🐦 Follow @LexpertAI on X for skill updates and releases
  • 🛠️ New filesystem features and enhancements
  • 📋 Best practices for file management automation
  • 💡 Tips and tricks for productivity workflows

Get early access to new skills and improvements by following @LexpertAI for:

  • Skill announcements and new releases
  • Performance optimizations and feature updates
  • Integration examples and workflow automation
  • Community discussions on productivity tools

License

MIT License - Free for personal and commercial use.


Remember: Great filesystem management starts with the right tools. This skill provides comprehensive operations while maintaining safety and performance.

04 同仓库更多 Skills

meghal86
meghal86/stacksignal

zvukogram

Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.

★ 0
meghal86
meghal86/stacksignal

zohomail

Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.

★ 0
meghal86
meghal86/stacksignal

zoho-recruit

Zoho Recruit API integration with managed OAuth. Manage candidates, job openings, interviews, and recruitment workflows. Use this skill when users want to read, create, update, or search recruitment data like candidates, job openings, interviews, and applications in Zoho Recruit. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.

★ 0
meghal86
meghal86/stacksignal

zoho-people

Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, and leave. Use this skill when users want to read, create, update, or query HR data like employees, departments, designations, and forms in Zoho People. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.

★ 0
meghal86
meghal86/stacksignal

zoho-mail

Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.

★ 0
meghal86
meghal86/stacksignal

zoho-inventory

Zoho Inventory API integration with managed OAuth. Manage items, sales orders, invoices, purchase orders, bills, contacts, and shipments. Use this skill when users want to read, create, update, or delete inventory items, sales orders, invoices, purchase orders, bills, or other inventory records in Zoho Inventory. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.

★ 0