trailsnap-cli SKILL.md skillA
trailsnap-cli from lc044/trailsnap is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add lc044/trailsnap/trailsnap-cli@git:20260906.ffbc281Pins git:20260906.ffbc281 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- lc044/trailsnap
- Path
skills/trailsnap-cli/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260906.ffbc281, committed Sep 6, 2026
- First version recorded
- Apr 27, 2026
- Size
- 2,440 bytes
- Repository stars
- 894
- License
- AGPL-3.0
Query photos, albums, locations, tags, and people from a TrailSnap instance through its command-line client. Use when TrailSnap MCP tools are unavailable and the user asks about their own photo library; Agent Tokens are read-only, so do not use this skill to mutate library data.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# TrailSnap CLI 技能 当原生 TrailSnap MCP 工具不可用时，使用 `trailsnap` CLI 查询 TrailSnap；两者同时可用时优先 MCP。 ## 功能 1. 根据指定条件（可选过滤参数）查询照片列表。 2. 查询分类标签、相册、位置和人物（面部）信息。 3. 查询某张照片的详细信息。 ## 安装 使用以下命令检查是否安装了 `trailsnap` 工具，如果没有安装则可以参考[install.md](install.md)文档进行安装。 ```bash trailsnap -v ``` ## 初始配置 首次使用需要配置 API 地址和 `ts_` 开头的只读 Agent Token。用以下命令检查配置： ```bash trailsnap photos list --limit 1 ``` 如果收到配置错误，询问用户这两个信息，然后执行；不要把 Token 输出到日志或提交到仓库： ```bash trailsnap config set --url <API_BASE_URL> --token <YOUR_API_TOKEN> ``` ## 使用方法 使用前可以通过 `trailsnap <command> -h` 或 `trailsnap <command> <subcommand> -h` 查看每个命令的详细帮助信息。通常情况下，你需要先根据用户的问题逐步筛选出检索条件（一个简单的[示例](examples/simple.md)），然后查询符合条件的照片列表。 - `locations timeline` 命令能够查到时间和空间上的信息，是一个很好的工具，返回一个足迹时间轴（某一段时间去了那个地方）。 - 除非用户不需要显示照片，否则以合适格式展示照片；使用 `medias get --format url` 获取地址，保留返回值，不要编造路径。 - 在使用之前你需要阅读 [reference.md](reference.md) 文件，了解每个命令的详细参数和选项。 - 如果需要的话，可以参考 [examples/simple.md](examples/simple.md) 文件，了解如何使用该工具。 - Agent Token 仅允许匹配 scope 的读取。不要调用删除、toolbox、任务变更、上传或其他写命令，也不要声称已经修改相册。 - AI 描述、人脸匹配与回忆候选属于推断证据，不应表述为已确认事实。 使用 Python 运行脚本： ```bash trailsnap <command> <subcommand> [options] ```
Read the whole file at its exact version.
How to install
mdr add lc044/trailsnap/trailsnap-cli@sha256:da383188949f01b6The line at the top of this page pins the label git:20260906.ffbc281, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_fvlb2xkhnm6w7vxi)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Apr 27, 2026 and Sep 6, 2026, about one every 131 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260906.ffbc281 latest | 2026-09-06 | ffbc281 | 2,440 B | A | view · diff |
| git:20260427.a3dcca6 | 2026-04-27 | a3dcca6 | 2,749 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2440 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
lc044/trailsnap · 894 stars · license AGPL-3.0 · pushed 2026-11-07 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_fvlb2xkhnm6w7vxi GET https://markdownregistry.com/api/v1/resolve?ref=lc044/trailsnap/trailsnap-cli GET https://markdownregistry.com/api/v1/blob/da383188949f01b657c89f4c677cf3009b5c87de0d2043003ed8e6f8c47eb7f7
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.