Clawdbot Filesystem 1.0.2

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

Security Scan

The skill's declared purpose (filesystem CLI) mostly matches its instructions, but the package is incomplete/inconsistent (references a 'filesystem' executable that is not present) and some metadata mismatches raise concern — inspect before installing or running.

Purpose & Capability

Name, description, and SKILL.md describe a filesystem CLI and require only node — that is coherent. However package.json and SKILL.md both reference a 'filesystem' binary/entrypoint and show a bin mapping, yet no executable file named 'filesystem' is present in the provided file manifest. This missing artifact (and a small version mismatch between registry metadata and package.json/package-lock) is an inconsistency: either the skill is incompletely packaged or it expects additional files from the remote repo. That makes the skill incomplete and requires extra steps that should be audited.

Instruction Scope

The SKILL.md instructions stay within filesystem management scope: list, search, copy, analyze, install via git/ClawdHub, and editing config.json. The instructions do not ask the agent to read unrelated system files or siphon environment variables. They do instruct cloning a repo and making an executable, which is expected for a CLI skill but needs the missing executable to be present in the repo.

Install Mechanism

No formal install spec is provided (instruction-only), which is lower-risk from automatic execution perspective. Installation instructions rely on 'git clone' or ClawdHub; repository URLs are provided in README. Because the package lacks the actual 'filesystem' binary, installing will require fetching additional content from the listed GitHub repo — fetching arbitrary code from a remote repo increases risk and should be reviewed. There are no opaque download URLs or archive-extract steps in the manifest.

Credentials

The skill requests only node as a required binary and declares no environment variables or config paths. package.json lists filesystem read-write permission which is appropriate for a filesystem tool. No unrelated credentials or environment access are requested.

Persistence & Privilege

always is false and disable-model-invocation is false (normal). There is no install script declared that would force persistent background behavior, and the SKILL.md does not instruct modifying other skills or global agent settings. The skill does request filesystem read/write in package metadata which is reasonable for its purpose.

What to consider before installing

This skill largely does what it says, but exercise caution because the package appears incomplete. Before installing or running: 1) Inspect the GitHub repository listed (https://github.com/gtrusler/clawdbot-filesystem) to confirm the 'filesystem' executable/script exists and review its source for network calls, eval/child_process usage, or obfuscated code. 2) Verify release tags and checksums if you download a binary. 3) Do not run install or clone commands as root; test in a contained environment (VM/container) first. 4) Confirm the skill's protective settings (protectedPaths, requireConfirmation) are implemented in the executable and not just documented in SKILL.md/config.json. 5) If you cannot verify the executable or if the repo differs from the package metadata (missing files, version mismatch), treat the package as untrusted and avoid installing it.

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