Taizi Filesystem

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

Security Scan

The skill's description and manifest claim a CLI 'filesystem' tool, but no executable or implementation is included and the package declares broad filesystem read-write permissions — this mismatch and the potential for arbitrary file access merit caution.

Purpose & Capability

The SKILL.md, README, and package.json describe a CLI named 'filesystem' (bin -> ./filesystem, main -> 'filesystem') and give many runtime examples, but the skill bundle contains no executable/script named 'filesystem' or implementation files. The skill also lists 'node' as a required binary despite no Node code being present to run. This is an implementation mismatch: the described capability is not actually included in the package.

Instruction Scope

The runtime instructions and examples direct the agent to perform broad filesystem operations (read, search, copy, analyze) across arbitrary paths including system locations (/var/log, /etc). Although SKILL.md and config.json mention safety features (protectedPaths, dry-run, permission checks), there is no shipped code to enforce them. That means the described operations — if implemented elsewhere — could access sensitive files; the instructions as written grant the agent wide discretion to scan and copy files.

Install Mechanism

This is instruction-only (no install spec), which is low install-surface risk. However SKILL.md recommends cloning from GitHub or using ClawdHub and then making a './filesystem' executable; the repo bundle provided here does not include that executable. The absence of a defined, verifiable install artifact (and discrepancy between package.json and the actual files) is a packaging/integrity problem.

Credentials

The skill requests no environment variables or credentials, which is appropriate. package.json advertises 'permissions.filesystem': 'read-write' and 'network':'none' — filesystem read-write access is necessary for the claimed functionality but is broad and enables reading arbitrary files. Network:none reduces exfiltration via network, but the agent can still return file contents in responses, so risk remains. The requested/specified permissions are not unreasonable for a filesystem tool, but are expansive and should be limited or reviewed before use.

Persistence & Privilege

The skill is not marked always:true and does not request persistent platform privileges. It is user-invocable and allows autonomous invocation (platform default). There is no evidence it modifies other skills or system-wide configs.

What to consider before installing

Do not install or enable this skill without verification. Key issues: the package advertises a 'filesystem' CLI but the bundle lacks the executable/implementation — this is an integrity/packaging mismatch. Before using: (1) inspect the upstream repository (https://github.com/gtrusler/clawdbot-filesystem) and verify the exact files and the filesystem binary/script; (2) review the implementation to confirm safety checks (path validation, protectedPaths enforcement, dry-run behavior) actually exist; (3) run the tool in a sandbox or VM first and test 'dry-run' operations; (4) avoid granting this skill broad/always-on access and limit agent privileges; (5) because it can access arbitrary files, don't run it against sensitive systems until you confirm the code; if you can't validate the implementation, treat the skill as untrusted and do not install.

📁 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.