Trailsnap CLI Agent Skill
TrailSnap CLI 命令行工具，用于查询照片、相册、标签、位置和人物等信息。当用户需要查看照片、相册数据时调用此技能。
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/LC044/TrailSnap --skill trailsnap-cliThe instruction itself
2 sections, as written by the authorTrailSnap CLI 技能
此技能允许使用 trailsnap工具 与 TrailSnap 后端 API 进行交互。
功能
- 根据指定条件（可选过滤参数）查询照片列表。
- 查询分类标签、相册、位置和人物（面部）信息。
- 查询某张照片的详细信息。
安装
使用以下命令检查是否安装了 trailsnap 工具，如果没有安装则可以参考install.md文档进行安装。
trailsnap -v
初始配置
首次使用该工具时，需要配置 API 地址和 Token。你可以使用以下命令来判断是否需要配置 API 地址和 Token：
trailsnap photos list --limit 1
如果你收到错误信息，说明你需要配置 API 地址和 Token。可以询问用户这两个信息，然后通过以下命令进行配置：
trailsnap config set --url <API_BASE_URL> --token <YOUR_API_TOKEN>
使用方法
使用前可以通过 trailsnap <command> -h 或 trailsnap <command> <subcommand> -h 查看每个命令的详细帮助信息。通常情况下，你需要先根据用户的问题逐步筛选出检索条件（一个简单的示例），然后查询符合条件的照片列表。
locations timeline命令能够查到时间和空间上的信息，是一个很好的工具，返回一个足迹时间轴（某一段时间去了那个地方）。- 除非用户不需要显示照片，否则都要以合适的格式展示照片，如果需要显示某张照片，你可以使用
medias命令获取其URL地址或者照片文件。 - 在使用之前你需要阅读 reference.md 文件，了解每个命令的详细参数和选项。
- 如果需要的话，可以参考 examples/simple.md 文件，了解如何使用该工具。
使用 Python 运行脚本：
trailsnap <command> <subcommand> [options]
生成的 HTML 页面规范
- 整体风格：极简轻复古治愈手账风，低饱和莫兰迪配色，奶白米杏主色调，柔和浅阴影、统一大圆角；
- 布局：响应式卡片布局，时间倒序展示；
- 单卡片结构：日期头部→相册图片区→日记正文→轻量化标签；
- 视觉：无高饱和颜色、无复杂动效、无冗余组件，字体舒适留白充足；
- 功能：支持单图/多图相册展示、标签分类、图片点击放大；
- 产出要求：纯轻量化HTML，结构整洁，适配本地静态浏览，对接相册图片url地址直接预览，文案温柔生活化。
Other skills for the same job
different authors, same section of the catalogue
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
Next.js best practices - file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, route handlers, image/font optimization, bundling
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification
How to use it
Take lc044/trailsnap-cli from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.