← Back to Skills Marketplace
lc044

trailsnap-cli

by LC044 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
65
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install trailsnap-cli
Description
TrailSnap CLI 命令行工具,用于查询照片、相册、标签、位置和人物等信息。当用户需要查看照片、相册数据时调用此技能。
Usage Guidance
This skill appears to implement a CLI that talks to a TrailSnap API and stores a bearer token in a local .env file. Before installing or using it: (1) confirm the skill's origin/publisher (source is unknown); (2) be aware your API token will be saved in plaintext in the skill directory — avoid using highly privileged tokens or use an isolated account; (3) verify the configured TRAILSNAP_API_URL points to a trusted server (the code will call whatever base URL you set); (4) note the SKILL.md claim that the agent "cannot directly read .env" contradicts the code: the tool reads .env at runtime, so do not rely on that text as a security guarantee; (5) if you still want to use it, run it in a sandbox or VM, inspect the code yourself, and rotate the token after use. Provide the publisher/source or provenance if you want a higher-confidence assessment.
Capability Analysis
Type: OpenClaw Skill Name: trailsnap-cli Version: 1.0.0 The skill bundle provides a CLI for interacting with a photo management API, but it contains a significant security vulnerability in `commands/medias.py`. The `get` subcommand allows writing downloaded media to an arbitrary file path via the `--output` argument without any path validation or sanitization, which could be exploited for arbitrary file overwrites. While the code logic is aligned with the stated purpose and lacks clear evidence of malicious intent, this lack of input sanitization on file operations is a high-risk flaw.
Capability Assessment
Purpose & Capability
The name/description align with the implementation: the CLI provides commands to query photos, albums, tags, locations, people, folders and media via a TrailSnap API. However the skill metadata declares no required env vars while the code requires an API URL and token (saved to/loaded from a local .env file). Also SKILL.md states the agent "cannot directly read the .env file," which contradicts runtime code that reads .env for the API URL and token.
Instruction Scope
SKILL.md restricts usage to the CLI and instructs users to run 'config set' to save API URL and token into .env; it does not ask the agent to read unrelated files. But the explicit admonition that the agent/skill "cannot directly read .env" is misleading: the provided code (utils.load_env / make_request) does read the .env file at runtime to obtain credentials. There are no instructions to exfiltrate data to unexpected endpoints—the API calls go to the configured TRAILSNAP_API_URL.
Install Mechanism
No install spec or remote downloads are present; this is an instruction-and-code bundle with local Python code only. No external installation URLs, package installs, or archive extraction are used.
Credentials
The metadata lists no required environment variables, yet the code requires and writes an API token and base URL into a plaintext .env file (TRAILSNAP_API_TOKEN / TRAILSNAP_API_URL). Storing a bearer token in a local .env file may expose credentials if the skill or host environment is shared. The number of secrets requested (one API token) is reasonable for the task, but the mismatch between declared requirements and actual behavior is concerning.
Persistence & Privilege
always is false and the skill does not request system-wide privileges. It writes a local .env file in its directory to persist configuration, which is expected for a CLI tool and does not 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 trailsnap-cli
  3. After installation, invoke the skill by name or use /trailsnap-cli
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of trailsnap-cli. - Provides command-line access to query photos, albums, tags, locations, and people. - Supports listing mounted storage directories. - Requires one-time configuration of API URL and token. - Offers built-in command help and usage examples.
Metadata
Slug trailsnap-cli
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is trailsnap-cli?

TrailSnap CLI 命令行工具,用于查询照片、相册、标签、位置和人物等信息。当用户需要查看照片、相册数据时调用此技能。 It is an AI Agent Skill for Claude Code / OpenClaw, with 65 downloads so far.

How do I install trailsnap-cli?

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

Is trailsnap-cli free?

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

Which platforms does trailsnap-cli support?

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

Who created trailsnap-cli?

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

💬 Comments