# Filesystem

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

- **Type:** Skill
- **Install:** `agentstack add skill-security-pride-malskills-latest-a73889c943e6`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [security-pride](https://agentstack.voostack.com/s/security-pride)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [security-pride](https://github.com/security-pride)
- **Source:** https://github.com/security-pride/MalSkills/tree/main/data/ground_truth/benign/clawhub/gtrusler_clawdbot-filesystem/latest_a73889c943e6
- **Website:** https://doi.org/10.1145/3832783.3834375

## Install

```sh
agentstack add skill-security-pride-malskills-latest-a73889c943e6
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

```bash
# 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 ` - Target directory (default: current)
- `--recursive, -r` - Include subdirectories
- `--filter, -f ` - Filter files by pattern
- `--details, -d` - Show detailed information
- `--sort, -s ` - Sort by name|size|date
- `--format ` - Output format: table|json|list

### `filesystem search`
Search files by name patterns or content.

**Options:**
- `--pattern ` - Search pattern (glob or regex)
- `--path, -p ` - Search directory
- `--content, -c` - Search file contents
- `--context ` - Show context lines
- `--include ` - Include file patterns
- `--exclude ` - Exclude file patterns

### `filesystem copy`
Batch copy files with pattern matching and safety checks.

**Options:**
- `--pattern ` - Source file pattern
- `--to ` - 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 ` - Root directory
- `--depth, -d ` - 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 ` - Target directory
- `--stats` - Show detailed statistics
- `--types` - Analyze file types
- `--sizes` - Show size distribution
- `--largest ` - Show N largest files

## Installation

```bash
# Clone or install the skill
cd ~/.clawdbot/skills
git clone 

# Or install via ClawdHub
clawdhub install filesystem

# Make executable
chmod +x filesystem/filesystem
```

## Configuration

Customize behavior via `config.json`:

```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
```bash
# 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
```bash
# 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](https://x.com/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.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [security-pride](https://github.com/security-pride)
- **Source:** [security-pride/MalSkills](https://github.com/security-pride/MalSkills)
- **License:** Apache-2.0
- **Homepage:** https://doi.org/10.1145/3832783.3834375

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-security-pride-malskills-latest-a73889c943e6
- Seller: https://agentstack.voostack.com/s/security-pride
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.