Agent Economy Report

Skill code audit

CAUTION version 1.0.2 · audited 2026-09-17

clawdbot-filesystem @gtrusler

This package describes a filesystem CLI for listing, searching, copying, tree display, and directory analysis. The reviewed files are documentation, metadata, and configuration; the actual executable that package.json points to was not included, so its code could not be verified. The metadata requests broad read-write filesystem access, although the included config limits operations to read, copy, and analyze and lists protected system paths. Documentation contains shell installation commands and promotional links, but no malicious code, obfuscation, credential theft, persistence, payment redirection, or network access is present in the reviewed files. Caution is warranted because the executable is missing from review and the requested filesystem access is broad.

Declared purposeAdvanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot
Observed behaviorThe package as reviewed consists of documentation, metadata, and configuration only. It declares a Node CLI at ./filesystem but that file is not among the reviewed files. The materials describe list, search, copy, tree, and analyze commands, provide shell-based installation and test examples, and include package metadata requesting filesystem read-write access while declaring network and system access as none.
Verdict, rules onlySAFE
Verdict, AICAUTION
Final verdictCAUTION (never better than either pass)

Capabilities

capabilityvs purposedetail
filesystem_readneededThe declared purpose requires reading directories and file contents for list, search, tree, and analyze operations.
filesystem_writeneededThe copy command and package metadata request write capability. The included config limits allowedOperations to read, copy, and analyze.
shellexceeds purposeNo executable body was included for review. Documentation shows shell commands such as git, chmod, npm, and node for installation and testing.
networkexceeds purposePackage metadata declares network: none. External links appear only in documentation; no network code was observed.
install_packagesexceeds purposeREADME instructs npm install -g . and package.json includes npm link scripts, but automatic package installation behavior was not observed in the reviewed files.
otherexceeds purposeThe declared ./filesystem executable is not present in the reviewed package, preventing full behavioral verification.

Findings

severityfinding
mediumDeclared executable file not included in review
package.json points the command name filesystem to ./filesystem, but no file named filesystem was present among the package files reviewed, so its actual behavior cannot be verified.
package.json:7 "filesystem": "./filesystem"
mediumSkill requests read-write filesystem access
The metadata declares read-write filesystem permission. This permits reading local files and writing or copying them, which is broader than read-only and requires user review.
package.json:57 "filesystem": "read-write",
infoNetwork permission denied in metadata
The package declares no network permission. External links appear only in documentation and are not observed network calls from code.
package.json:59 "network": "none",
infoRequires Node.js runtime
The skill declares Node.js as a runtime requirement. Any CLI execution would rely on node being available.
package.json:54 "bins": ["node"]
infoConfigured operations are limited
The configuration restricts allowed operations to read, copy, and analyze. Destructive operations such as delete or arbitrary write are not listed.
config.json:31 "allowedOperations": ["read", "copy", "analyze"],
infoProtected system paths configured
The configuration includes protected paths such as /etc, with additional entries for /var/lib, /usr/bin, /system, C:\Windows, and C:\Program Files.
config.json:33 "/etc",
mediumPublisher discloses broad read-write risk
The skill card acknowledges that broad local filesystem access and search/copy behavior can touch private or unintended directories.
skill-card.md:25 Risk: The skill requests broad read-write local filesystem access, including search and copy behavior that can touch private or unintended directories.
lowManual install instructs cloning remote repository
The README instructs users to clone from GitHub. This fetches external code before installation.
README.md:47 git clone https://github.com/gtrusler/clawdbot-filesystem.git
lowManual install instructs global npm install
The README instructs global npm installation, which can place a command on PATH and execute package scripts.
README.md:54 npm install -g .
infoTest example writes a file
The README testing example uses shell redirection to create test.txt. This is a manual test command, not observed package code.
README.md:241 echo "TODO: Test this function" > test.txt
lowDebug command executes a node one-liner
The README troubleshooting section shows a node -e command to read config.json. It is an instruction, not observed automatic execution.
README.md:275 node -e "console.log(require('./config.json').performance)"
lowPromotional external social link
The documentation promotes following an X account. This is external promotion; no code in the reviewed files performs network access.
README.md:309 - 🐦 **Follow [@LexpertAI](https://x.com/LexpertAI)** on X for skill updates and releases

0 AI finding(s) were dropped because their file, line or quote did not match the package.

Network destinations in the code

domainservice ratingwhere
clawdhub.comnot in the service indexREADME.md:5
clawhub.ainot in the service indexskill-card.md:9
docs.clawd.botnot in the service indexREADME.md:303
github.comnot in the service indexREADME.md:47
img.shields.ionot in the service indexREADME.md:5
nodejs.orgnot in the service indexREADME.md:7
x.comnot in the service indexREADME.md:309

Other facts

Binaries invokedbash, chmod, git, node, npm
Environment variables readnone
Hard-coded walletsnone
Pipes a download to a shell0
eval / exec / subprocess0
base64 blobs0
File writes0
Persistence0

Files audited

filelinessha256
LICENSE.md21ecab1e261aab2aa4…
README.md322bd14e682785513a8…
SKILL.md208c36367f5492e8eec…
_meta.json6885194202e4f71b7…
config.json41cd666d38f84b12ce…
package.json69ef41ecff5b1c1539…
skill-card.md50445c6f123fd16e85…

For agents

JSON: https://agenteconomy.report/k/clawdbot-filesystem.audit.json · badge: https://agenteconomy.report/k/clawdbot-filesystem.audited.svg · skill rating: /k/clawdbot-filesystem · commission an audit of any skill: US$ 29 per version.

How this is computed

The complete published package of this exact version was downloaded from the registry and read statically; nothing was executed. A deterministic pass extracts network destinations, binaries, environment variables, writes, install commands, obfuscation markers, subprocesses and wallets, each with file and line. An AI then reads the whole package with those facts and writes the summary, the capabilities and the findings under a strict schema; every finding it produces must cite a file, a line and the exact text, or it is dropped. The final verdict is the worst of the two passes. The audit does not change the skill's trust tier (policy); the author may respond through the dispute channel and the response is published here. Commissioned by: the Agent Economy Report (free program: the 150 most downloaded skills, September 2026).