← Back to Skills Marketplace
bytesagain3

Finder

by bytesagain3 · GitHub ↗ · v3.0.0 · MIT-0
cross-platform ⚠ suspicious
432
Downloads
0
Stars
1
Active Installs
6
Versions
Install in OpenClaw
/install finder
Description
Find files by name, size, date, and type with deduplication. Use when searching filesystems.
README (SKILL.md)

finder

Find files by name, size, date, and type with deduplication. Use when searching filesystems.

Commands

name

scripts/script.sh name \x3Cpattern dir>

size

scripts/script.sh size \x3Cmin dir>

recent

scripts/script.sh recent \x3Cdir days>

type

scripts/script.sh type \x3Cext dir>

empty

scripts/script.sh empty \x3Cdir>

large

scripts/script.sh large \x3Cdir count>

Data Storage

Data stored in ~/.local/share/finder/.


Powered by BytesAgain | bytesagain.com | [email protected]

Usage Guidance
This skill appears coherent and local-only: it runs a bundled shell script that uses find/sort/head to list files and does not call external services or request secrets. Before installing, review whether you or your agent will pass untrusted input to the script—because several arguments are unquoted, crafted inputs with spaces or shell metacharacters could behave unexpectedly. If you plan to use it in automation, either ensure arguments are sanitized/quoted or patch the script to properly quote variables (e.g., use "${var}" in find invocations). Also note the script creates ~/.local/share/finder but currently doesn't persist other data; that is harmless but worth being aware of.
Capability Analysis
Type: OpenClaw Skill Name: finder Version: 3.0.0 The script 'scripts/script.sh' contains multiple shell injection vulnerabilities because user-provided arguments are passed unquoted to shell commands like 'find' and 'head' (e.g., in cmd_name, cmd_size, and cmd_large). This allows for arbitrary command execution if the input contains shell metacharacters. While the tool's functionality aligns with its description as a file finder, the lack of input sanitization and the presence of unusual padding (large blocks of empty comments) in the script make it high-risk, though there is no explicit evidence of intentional malice or data exfiltration.
Capability Assessment
Purpose & Capability
Name/description align with the included assets: SKILL.md documents commands that call scripts/script.sh, and that script implements searching by name, size, date, type, emptiness, and largest files. No unrelated credentials, binaries, or downloads are requested.
Instruction Scope
SKILL.md instructs the agent to run the bundled shell script; the script only invokes local find/sort/head utilities and writes no data externally. Minor concern: the script creates ~/.local/share/finder/ and claims data is stored there, but the script does not actually write persistent data beyond creating the directory. Also some command arguments in the script are unquoted (e.g., find ${3:-.} -name $2), which can lead to unexpected word-splitting or glob expansion if arguments contain whitespace or shell metacharacters—sanitizing or quoting user-provided arguments would be safer.
Install Mechanism
No install specification or external downloads; instruction-only with a single shell script included in the package. Low risk from install mechanism.
Credentials
The skill requests no environment variables, credentials, or config paths. It reads $HOME to create a per-user data directory, which is proportionate to the declared Data Storage location.
Persistence & Privilege
always:false and no modifications to other skills or system-wide settings. The script creates a per-user directory (~/.local/share/finder) but does not modify other agent configs or request elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install finder
  3. After installation, invoke the skill by name or use /finder
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.0.0
v3.0.0: rewrite
v1.0.4
old template -> domain-specific v2.0.0
v1.0.3
old template -> domain-specific v2.0.0
v1.0.2
Quality upgrade
v1.0.1
De-template, unique content, script cleanup
v1.0.0
Initial release
Metadata
Slug finder
Version 3.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 6
Frequently Asked Questions

What is Finder?

Find files by name, size, date, and type with deduplication. Use when searching filesystems. It is an AI Agent Skill for Claude Code / OpenClaw, with 432 downloads so far.

How do I install Finder?

Run "/install finder" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Finder free?

Yes, Finder is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Finder support?

Finder is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Finder?

It is built and maintained by bytesagain3 (@bytesagain3); the current version is v3.0.0.

💬 Comments