TrailSnap CLI
Query photos, albums, locations, and tags from your TrailSnap photo library.
Installation
- Make sure Claude is on your device and in your terminal.
Skills load from
~/.claude/skills/when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then runclaudein any terminal to verify.One-time setupnpm i -g @anthropic-ai/claude-codeAlready have it? Skip ahead.
- Paste into Claude Code or into your terminal.
This copies the whole skill folder into
~/.claude/skills/trailsnap-cli-lc044/— the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.Faster alternative (instruction-only skills)
Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.
Quick install (SKILL.md only)Sign up to copy - Restart Claude Code.
Quit and reopen Claude Code (or any other agent that loads from
~/.claude/skills/). New skills are picked up on startup. - Just ask Claude.
Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.
Prefer to read the source first? Open on GitHub.
When Claude uses it
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.
What this skill does
TrailSnap CLI 技能
当原生 TrailSnap MCP 工具不可用时,使用 trailsnap CLI 查询 TrailSnap;两者同时可用时优先 MCP。
功能
- 根据指定条件(可选过滤参数)查询照片列表。
- 查询分类标签、相册、位置和人物(面部)信息。
- 查询某张照片的详细信息。
安装
使用以下命令检查是否安装了 trailsnap 工具,如果没有安装则可以参考install.md文档进行安装。
trailsnap -v
初始配置
首次使用需要配置 API 地址和 ts_ 开头的只读 Agent Token。用以下命令检查配置:
trailsnap photos list --limit 1
如果收到配置错误,询问用户这两个信息,然后执行;不要把 Token 输出到日志或提交到仓库:
trailsnap config set --url <API_BASE_URL> --token <YOUR_API_TOKEN>
使用方法
使用前可以通过 trailsnap <command> -h 或 trailsnap <command> <subcommand> -h 查看每个命令的详细帮助信息。通常情况下,你需要先根据用户的问题逐步筛选出检索条件(一个简单的示例),然后查询符合条件的照片列表。
locations timeline命令能够查到时间和空间上的信息,是一个很好的工具,返回一个足迹时间轴(某一段时间去了那个地方)。- 除非用户不需要显示照片,否则以合适格式展示照片;使用
medias get --format url获取地址,保留返回值,不要编造路径。 - 在使用之前你需要阅读 reference.md 文件,了解每个命令的详细参数和选项。
- 如果需要的话,可以参考 examples/simple.md 文件,了解如何使用该工具。
- Agent Token 仅允许匹配 scope 的读取。不要调用删除、toolbox、任务变更、上传或其他写命令,也不要声称已经修改相册。
- AI 描述、人脸匹配与回忆候选属于推断证据,不应表述为已确认事实。
使用 Python 运行脚本:
trailsnap <command> <subcommand> [options]
Related skills
PowerPoint Slide Decks
anthropics
Create, edit, read, and extract content from PowerPoint presentations.
Memory Search
davila7
Search conversation history and recall previous discussions, decisions, and context.
Slide Deck Creator
daymade
Generate professional PowerPoint presentations with structured content, charts, and speaker notes.
Competitive Ads Extractor
Prat011
Extract and analyze competitors' ads to discover messaging and creative strategies that work.