Agent Economy Report

Skill code audit

CAUTION version 1.2.2 · audited 2026-09-17

clawddocs @nicholasspisak

This package presents itself as a Clawdbot documentation helper. It mostly contains markdown guidance and simple shell scripts that print messages rather than actually downloading, searching, or tracking documentation. No code was found that reads or transmits credentials, installs software, persists on the machine, or contacts hidden destinations. The main concerns are that the advertised search, fetch, index, and tracking functions are only stubs, and one configuration example shows a gateway binding to all network interfaces. No malicious behavior was found, but users should review the scripts and generated configuration before relying on them.

Declared purposeClawdbot documentation expert with decision tree navigation, search scripts, doc fetching, version tracking, and config snippets for all Clawdbot features
Observed behaviorThe skill instructs the agent to choose documentation paths, run helper shell scripts, and use browser or configuration snippets. The shell scripts use bash but only echo status messages or user-supplied values; they do not actually fetch, search, index, cache, or snapshot anything. External references are docs.clawd.bot and a clawhub.ai profile link. Snippets include Discord and Telegram token environment-variable placeholders and a gateway host 0.0.0.0 example.
Verdict, rules onlyCAUTION · reads credential-like environment variables: DISCORD_TOKEN, TELEGRAM_TOKEN
Verdict, AICAUTION
Final verdictCAUTION (never better than either pass)

Capabilities

capabilityvs purposedetail
shellneededSKILL.md directs the agent to run scripts such as ./scripts/sitemap.sh and ./scripts/search.sh; each script has a bash shebang and uses echo/case statements. No destructive shell command was found.
networkneededThe declared purpose is fetching and searching documentation from docs.clawd.bot, but the included scripts only echo URLs and do not make network requests.
browserneededSKILL.md line 128 says to fetch documentation with the script or use a browser.
credentialsexceeds purposesnippets/common-configs.md lines 9 and 23 contain ${DISCORD_TOKEN} and ${TELEGRAM_TOKEN} placeholders. No script reads or transmits these variables.

Findings

severityfinding
infoDeclared purpose
This is the stated purpose of the package. The included scripts do not fully implement the search, fetching, indexing, and tracking features described here.
SKILL.md:3 description: Clawdbot documentation expert with decision tree navigation, search scripts, doc fetching, version tracking, and config snippets for all Clawdbot f
infoShell helper script usage
The skill instructs the agent to run local shell scripts. This requires shell capabilities in the host agent.
SKILL.md:50 ./scripts/sitemap.sh # Show all docs by category
mediumDoc fetch script is a stub
Despite the command name and advertised doc-fetching, this script only prints the URL and does not download or fetch the document.
scripts/fetch-doc.sh:7 echo "Fetching: https://docs.clawd.bot/$1"
mediumSearch script is a stub
The advertised keyword search does not search an index or documentation; it only echoes the provided keyword.
scripts/search.sh:7 echo "Searching docs for: $1"
mediumFull-text index download is a stub
SKILL.md says this requires qmd and can download all docs, but the script only prints a message and never invokes qmd or downloads anything.
scripts/build-index.sh:5 echo "Downloading all docs..."
lowVersion tracking is a stub
The snapshot, list, and since commands only print messages; they do not save or compare any state.
scripts/track-changes.sh:5 echo "Saving current state..."
infoSitemap script is a local category lister
The script prints hard-coded category names and does not fetch or parse a sitemap from docs.clawd.bot.
scripts/sitemap.sh:22 echo "📁 /$cat/"
mediumExample binds gateway to all interfaces
If copied into a real configuration, this would expose the gateway on all network interfaces. skill-card.md lines 25-27 acknowledge this risk and recommend using 127.0.0.1 or adding authentication/firewall controls.
snippets/common-configs.md:41 "host": "0.0.0.0",
infoDiscord token placeholder in config snippet
This uses an environment variable placeholder for a sensitive credential. No script reads or transmits the variable; it is an example configuration.
snippets/common-configs.md:9 "token": "${DISCORD_TOKEN}",
infoPublisher acknowledges gateway exposure risk
The package itself documents the risk associated with the 0.0.0.0 example, so the risky config is not hidden.
skill-card.md:25 Risk: Copying the gateway example with host 0.0.0.0 can expose a local service if network controls are not in place.

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

Network destinations in the code

domainservice ratingwhere
clawhub.ainot in the service indexskill-card.md:9
docs.clawd.botnot in the service indexSKILL.md:138

Other facts

Binaries invokedbash
Environment variables readCATEGORIES, DAYS, DISCORD_TOKEN, TELEGRAM_TOKEN
Hard-coded walletsnone
Pipes a download to a shell0
eval / exec / subprocess0
base64 blobs0
File writes2
Persistence0

Files audited

filelinessha256
SKILL.md166114fb5408ffe9f0b…
_meta.json689313a792b1f69fa…
package.json94a3e6c6090ac9832…
scripts/build-index.sh170d35e8760b37dd2c…
scripts/cache.sh13a86f318b3a3f1116…
scripts/fetch-doc.sh7fe70080e81b93565…
scripts/recent.sh5a53e22fe1818710c…
scripts/search.sh8520eb36668567368…
scripts/sitemap.sh2392fe84e5597820b5…
scripts/track-changes.sh16d80f6bd0df132d58…
skill-card.md513524160718349bd5…
snippets/common-configs.md694140e9c3622efa67…

For agents

JSON: https://agenteconomy.report/k/clawddocs.audit.json · badge: https://agenteconomy.report/k/clawddocs.audited.svg · skill rating: /k/clawddocs · 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).