← Back to Skills Marketplace
ppopen

Local File Processor

by pp · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
363
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install openclaw-skill-local-file-processor
Description
Process local files with batch rename, format conversion, organization by date/type/metadata, duplicate detection, and metadata read/write/removal.
Usage Guidance
This skill appears to do what it says (batch renames, conversions, metadata edits, duplicate detection) but there are important inconsistencies and risks to consider before installing or running it: - Inconsistency: The registry lists no required binaries or install steps, yet the SKILL.md requires exiftool, ImageMagick, ffmpeg and an executable at ~/.openclaw/workspace/skills/local-file-processor/local-file-processor. Confirm where that executable comes from before making anything executable. - Verify before running: Do not run chmod or execute any binary placed in the workspace unless you have inspected its source. If the local-file-processor binary is provided separately, review its contents (source or vendor-signed release) first. - Test safely: Use --dry-run and operate on a copy/test directory before running destructive actions. Avoid --force or --action delete without backups. - Platform note: The install instructions use brew (macOS/Homebrew); if you use Linux/Windows ensure you install equivalent trusted packages (exiftool, imagemagick, ffmpeg) from your distro or official sources. - If you need assurance: Ask the publisher for a provenance link (source repo or release URL) or a proper install spec that places the executable from a trusted host. Without that, treat the skill as untrusted code that will operate on your local files. If you want, I can: (a) check whether the workspace executable already exists on your system (tell me the path contents), (b) suggest safe test commands to run with --dry-run, or (c) draft questions to ask the skill owner requesting a signed release or source repository.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-skill-local-file-processor Version: 1.0.0 The skill documentation (SKILL.md) describes a tool with high-risk capabilities, specifically broad file system access and destructive operations such as file deletion (via the 'duplicates' command). While these actions are aligned with the stated purpose of a file processor and include safety mechanisms like dry-run modes and path sanitization, the prompt's criteria classify such risky capabilities as suspicious even when plausibly needed. Furthermore, the actual implementation script ('local-file-processor') referenced in the installation instructions is missing from the bundle, making it impossible to verify the safety of the underlying code logic.
Capability Assessment
Purpose & Capability
The skill claims to be an instruction-only local file processor, which matches its commands (rename, convert, organize, duplicates, metadata). However, SKILL.md instructs installing exiftool, ImageMagick, and ffmpeg and to chmod a local executable at ~/.openclaw/workspace/skills/local-file-processor/local-file-processor. The registry metadata lists no required binaries and there is no install spec or bundled binary — that is an inconsistency: the skill will not function as written without external tools and an executable that is not provided.
Instruction Scope
The runtime instructions operate on arbitrary local files (rename, convert, delete, move, edit metadata), which is expected for this purpose but inherently dangerous. Instructions also tell the user/agent to make an executable in the skill workspace, yet no code is bundled; this step is out-of-band and could cause the agent to execute an unknown binary if one is placed there. The SKILL.md includes safety flags (dry-run, --force, confirmations) which help mitigate risk.
Install Mechanism
No formal install spec exists in the registry, but SKILL.md tells users to run 'brew install exiftool imagemagick ffmpeg' and to chmod a workspace binary. Relying on brew assumes macOS/Homebrew and the absence of a declared install mechanism or a trusted download URL for the local executable is an installation risk and a coherence problem.
Credentials
The skill does not request any environment variables, credentials, or config paths. No secret exfiltration indicators are present in the metadata. That said, it legitimately needs access to the filesystem, which is appropriate for its stated purpose.
Persistence & Privilege
The skill does not request 'always: true' and defaults to normal invocation behavior. It asks (in SKILL.md) to add an executable to the skill's workspace, which is typical for a CLI-based skill but there is no indication it will modify other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-skill-local-file-processor
  3. After installation, invoke the skill by name or use /openclaw-skill-local-file-processor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Skills Factory publish batch retry
Metadata
Slug openclaw-skill-local-file-processor
Version 1.0.0
License
All-time Installs 2
Active Installs 2
Total Versions 1
Frequently Asked Questions

What is Local File Processor?

Process local files with batch rename, format conversion, organization by date/type/metadata, duplicate detection, and metadata read/write/removal. It is an AI Agent Skill for Claude Code / OpenClaw, with 363 downloads so far.

How do I install Local File Processor?

Run "/install openclaw-skill-local-file-processor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Local File Processor free?

Yes, Local File Processor is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Local File Processor support?

Local File Processor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Local File Processor?

It is built and maintained by pp (@ppopen); the current version is v1.0.0.

💬 Comments