Agent skill

Filesystem

by sundial-org in sundial-org/awesome-openclaw-skills

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

Install Filesystem

skills CLI

$ npx skills add sundial-org/awesome-openclaw-skills --skill filesystem -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install sundial-org/awesome-openclaw-skills filesystem --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/filesystem .claude/skills/filesystem && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "filesystem" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/filesystem into .claude/skills/filesystem/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "filesystem", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/filesystem

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add sundial-org/awesome-openclaw-skills --skill filesystem -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install sundial-org/awesome-openclaw-skills filesystem --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/filesystem .agents/skills/filesystem && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "filesystem" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/filesystem into .agents/skills/filesystem/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "filesystem", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add sundial-org/awesome-openclaw-skills --skill filesystem -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install sundial-org/awesome-openclaw-skills filesystem --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/filesystem .cursor/skills/filesystem && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "filesystem" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/filesystem into .cursor/skills/filesystem/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "filesystem", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/sundial-org/awesome-openclaw-skills.git --path skills/filesystem

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add sundial-org/awesome-openclaw-skills --skill filesystem -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install sundial-org/awesome-openclaw-skills filesystem --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/filesystem .gemini/skills/filesystem && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "filesystem" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/filesystem into .gemini/skills/filesystem/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "filesystem", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install sundial-org/awesome-openclaw-skills filesystem

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add sundial-org/awesome-openclaw-skills --skill filesystem -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/filesystem .github/skills/filesystem && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "filesystem" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/filesystem into .github/skills/filesystem/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "filesystem", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add sundial-org/awesome-openclaw-skills --skill filesystem -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install sundial-org/awesome-openclaw-skills filesystem --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/filesystem .opencode/skills/filesystem && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "filesystem" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/filesystem into .opencode/skills/filesystem/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "filesystem", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: filesystem
GitHub stars: 663
Used in: 1 other repo
Token cost: ~1.6k tokens
SKILL.md length: 503 words
Files: 5
Skills in repo: 353
Repo updated: Mar 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

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

Tasks that involve Data pipelines and ETL
SKILL.md covers Features, Quick Start, Command Reference and Installation, plus 6 more sections
Calls git

What it does

Filesystem is an agent skill from sundial-org/awesome-openclaw-skills. Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `LICENSE.md`, `README.md` and `config.json`).

It sits in Data & Analytics, covering Data pipelines and ETL. The repository describes itself as: Top OpenClaw skills, with the most popular and useful ones. The licence is MIT.

When your agent uses it

Tasks that involve Data pipelines and ETL

Example prompts

“/filesystem”

What it can do on your machine

Read from SKILL.md and the folder at commit b80cde2. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- git
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- x.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Filesystem loads about 1.6k tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 503 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~29
When it runs · the whole SKILL.md, loaded when a task matches: ~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sundial-org/awesome-openclaw-skills at commit b80cde2, republished under its MIT licence (© sundial-org). 503 words, ~1,570 tokens.

Download SKILL.mdSave it as .claude/skills/filesystem/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.

name: filesystem
description: Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot
homepage: https://github.com/gtrusler/clawdbot-filesystem

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

Show full SKILL.md (206 more words)Show less

`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

bash

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

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

Files

SKILL.md and 4 other files in skills/filesystem of sundial-org/awesome-openclaw-skills.

SKILL.md
LICENSE.md
README.md
config.json
package.json

Open the folder on GitHubat commit b80cde2

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sundial-org/awesome-openclaw-skills, which our catalogue first saw on October 7, 2026.

LeoYeAI/openclaw-master-skillsskills/clawdbot-filesystem

Compare with similar skills

Filesystem next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Filesystem compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Filesystem this skillsundial-org/awesome-openclaw-skills	663	1 repos	~1.6k	Automated safety check: Pass	MIT	7 mo ago
Crawl4AI Web Scrapingsmallnest/goclaw	598	1 repos	~2.5k	Automated safety check: Pass	MIT	6 mo ago
Glue 09 10 Migrationaws-samples/aws-glue-samples	1.5k	—	~2.4k	Automated safety check: Pass	MIT-0	1 mo ago
Migrate Glue Devendpoint To Interactive Sessionsaws-samples/aws-glue-samples	1.5k	—	~3.6k	Automated safety check: Pass	MIT-0	1 mo ago
Dbt Databricks PR Readydatabricks/dbt-databricks	380	—	~2.8k	Automated safety check: Pass	Apache-2.0	today
Mz Dbt ReleaseMaterializeInc/materialize	6.4k	—	~1.2k	Automated safety check: Pass	Custom licence	today

Similar skills

Crawl4AI Web Scraping
smallnest/goclaw
Scrapes sites, handles JavaScript-heavy pages and extracts structured data with Crawl4AI, through its crwl CLI or Python SDK, including schema-based extraction without an LLM.
598 GitHub starsUsed in 1 repo~2.5k tokens
Data & AnalyticsAuto-check passed
Glue 09 10 Migration
aws-samples/aws-glue-samples
Official
Upgrade an AWS Glue ETL job from Glue version 0.9 or 1.0 to Glue 4.0.
1.5k GitHub stars~2.4k tokensUpdated 1 mo ago
Data & AnalyticsAuto-check passed
Migrate Glue Devendpoint To Interactive Sessions
aws-samples/aws-glue-samples
Official
Migrate a legacy AWS Glue development endpoint to a Glue interactive session, following the official AWS migration checklist.
1.5k GitHub stars~3.6k tokensUpdated 1 mo ago
Data & AnalyticsAuto-check passed
Dbt Databricks PR Ready
databricks/dbt-databricks
Official
A skill your agent uses for an open dbt-databricks pull request, including your own PR or a fork PR, to assess merge readiness and optionally repair selected gaps on the PR head branch.
380 GitHub stars~2.8k tokensUpdated today
Data & AnalyticsAuto-check passed
Mz Dbt Release
MaterializeInc/materialize
Cut a dbt-materialize PyPI release: bump the version in version.py and setup.py, date the Unreleased CHANGELOG entry, and open the release PR with a Ship: <url body.
6.4k GitHub stars~1.2k tokensUpdated today
Data & AnalyticsAuto-check passed
Erd Studio Setup
liam-machine/erd-studio
Friendly, step-by-step setup for ERD Studio in an existing dbt project, for people who may be new to dbt or data modelling.
165 GitHub stars~8.5k tokensUpdated today
Data & AnalyticsAuto-check passed

Questions about Filesystem

What does Filesystem do?

Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot. Filesystem is an agent skill from sundial-org/awesome-openclaw-skills.

When should I use Filesystem?

Filesystem fits situations like: tasks that involve Data pipelines and ETL.

How do I install Filesystem in Claude Code?

Run `npx skills add sundial-org/awesome-openclaw-skills --skill filesystem -a claude-code`. Or copy the skill folder (skills/filesystem in sundial-org/awesome-openclaw-skills) into .claude/skills/filesystem in your project. Claude Code loads it when a task matches its description.

How do I install Filesystem in Codex?

Run `npx skills add sundial-org/awesome-openclaw-skills --skill filesystem -a codex`. Or copy the skill folder (skills/filesystem in sundial-org/awesome-openclaw-skills) into .agents/skills/filesystem in your project. Codex loads it when a task matches its description.

Can I use Filesystem in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sundial-org/awesome-openclaw-skills --skill filesystem -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/filesystem, .gemini/skills/filesystem, .github/skills/filesystem and .opencode/skills/filesystem in your project.

What does Filesystem need to run?

Going by SKILL.md and its folder, Filesystem needs the command-line tools its instructions call (git).

Does Filesystem access the network?

SKILL.md names 1 domain. As links in the text: x.com. This is read from the text; nothing was executed.

Is Filesystem safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Filesystem use?

Filesystem is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Filesystem use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Filesystem?

Skills that share tags, products or a category with Filesystem: Crawl4AI Web Scraping (smallnest/goclaw, 598 stars), Glue 09 10 Migration (aws-samples/aws-glue-samples, 1.5k stars), Migrate Glue Devendpoint To Interactive Sessions (aws-samples/aws-glue-samples, 1.5k stars) and Dbt Databricks PR Ready (databricks/dbt-databricks, 380 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Filesystem?

sundial-org (a GitHub organization) maintains it in sundial-org/awesome-openclaw-skills, which has 663 GitHub stars. The repository holds 353 skills in this directory. The repository was last updated on March 7, 2026.

Source: sundial-org/awesome-openclaw-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Filesystem

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

📁 Filesystem Management

Features

📋 Smart File Listing

🔍 Powerful Search

🔄 Batch Operations

🌳 Directory Analysis

Quick Start

Command Reference

filesystem list

filesystem search

filesystem copy

filesystem tree

filesystem analyze

Installation

Configuration

Examples

Development Workflow

System Administration

Safety Features

Integration

Updates & Community

License

Files

Used in 1 other repository

Compare with similar skills

Similar skills

More from sundial-org/awesome-openclaw-skills

Related

Questions about Filesystem

`filesystem list`

`filesystem search`

`filesystem copy`

`filesystem tree`

`filesystem analyze`