Agent skill

Trailsnap CLI

by LC044 in LC044/TrailSnap

Query photos, albums, locations, tags, and people from a TrailSnap instance through its command-line client.

AGPL-3.0Auto-check passed

Install Trailsnap CLI

skills CLI
$ npx skills add LC044/TrailSnap --skill trailsnap-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install LC044/TrailSnap trailsnap-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/LC044/TrailSnap.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/trailsnap-cli .claude/skills/trailsnap-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
trailsnap-cli
GitHub stars
769
Used in
1 other repo
Token cost
~365 tokens
SKILL.md length
70 words
Files
4
Skills in repo
10
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Query photos, albums, locations, tags, and people from a TrailSnap instance through its command-line client.

  • Works in 3 steps: 根据指定条件(可选过滤参数)查询照片列表。 → 查询分类标签、相册、位置和人物(面部)信息。 → 查询某张照片的详细信息。
  • TrailSnap MCP tools are unavailable and the user asks about their own photo library
  • SKILL.md covers 功能, 安装, 初始配置 and 使用方法
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Trailsnap CLI is an agent skill from LC044/TrailSnap. 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.

Its SKILL.md is about 370 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `examples/simple.md`, `install.md` and `reference.md`).

The repository describes itself as: TrailSnap (行影集) | AI-Powered open-source photo album for travel & life memories.(AI赋能的开源相册工具,珍藏旅行与生活点滴). The licence is AGPL-3.0.

When your agent uses it

  • 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

Example prompts

  • “/trailsnap-cli”

Requirements

  • Python 3
  • A credential in YOUR_API_TOKEN

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 根据指定条件(可选过滤参数)查询照片列表。
  2. 查询分类标签、相册、位置和人物(面部)信息。
  3. 查询某张照片的详细信息。

What it can do on your machine

Read from SKILL.md and the folder at commit 9d4b63e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Trailsnap CLI loads about 365 tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 70 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~365

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from LC044/TrailSnap at commit 9d4b63e, republished under its AGPL-3.0 licence (© LC044). 70 words, ~365 tokens.

Download SKILL.mdSave it as .claude/skills/trailsnap-cli/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
trailsnap-cli
description
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.

TrailSnap CLI 技能

当原生 TrailSnap MCP 工具不可用时,使用 trailsnap CLI 查询 TrailSnap;两者同时可用时优先 MCP。

功能

  1. 根据指定条件(可选过滤参数)查询照片列表。
  2. 查询分类标签、相册、位置和人物(面部)信息。
  3. 查询某张照片的详细信息。

安装

使用以下命令检查是否安装了 trailsnap 工具,如果没有安装则可以参考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 查看每个命令的详细帮助信息。通常情况下,你需要先根据用户的问题逐步筛选出检索条件(一个简单的示例),然后查询符合条件的照片列表。

  • locations timeline 命令能够查到时间和空间上的信息,是一个很好的工具,返回一个足迹时间轴(某一段时间去了那个地方)。
  • 除非用户不需要显示照片,否则以合适格式展示照片;使用 medias get --format url 获取地址,保留返回值,不要编造路径。
  • 在使用之前你需要阅读 reference.md 文件,了解每个命令的详细参数和选项。
  • 如果需要的话,可以参考 examples/simple.md 文件,了解如何使用该工具。
  • Agent Token 仅允许匹配 scope 的读取。不要调用删除、toolbox、任务变更、上传或其他写命令,也不要声称已经修改相册。
  • AI 描述、人脸匹配与回忆候选属于推断证据,不应表述为已确认事实。

使用 Python 运行脚本:

bash
trailsnap <command> <subcommand> [options]

© LC044, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in skills/trailsnap-cli of LC044/TrailSnap.

  • SKILL.md
  • examples/simple.md
  • install.md
  • reference.md

Open the folder on GitHubat commit 9d4b63e

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in LC044/TrailSnap, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Trailsnap CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Trailsnap CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Trailsnap CLI this skillLC044/TrailSnap7691 repos~365Automated safety check: PassAGPL-3.0
MCP Server Builderanthropics/skills180k64 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
MCP Developmentcoollabsio/coolify63k1 repos~949Automated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 64 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • MCP Development

    coollabsio/coolify

    A skill your agent uses for Laravel MCP development. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 1 repo~949 tokens
    Frontend & DesignAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Analyze Logs

    activepieces/activepieces

    Analyze application logs from the .evlog/logs/ directory. An agent skill from activepieces/activepieces.

    25k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed

More from LC044/TrailSnap

All 10 skills in this repo
  • Release Publisher

    LC044/TrailSnap

    发布并验收 TrailSnap 新版本:汇总提交、同步全项目版本号、更新官网日志与客户端更新清单、执行发布前测试、创建 GitHub Release、监控标签 CI、核验 Release 附件,并生成小红书和公众号文案。Use when the user asks to 发布新版本、发版、创建或检查 GitHub Release、总结版本变更、监控发布 CI、检查发布产物,或撰写版本更新帖子。

    769 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Trailsnap Commit

    LC044/TrailSnap

    TrailSnap 仓库提交、推送、需求平台与 PR 工作流规则。Use when preparing commits, pushing branches, managing the corresponding platform requirement, creating or merging pull requests, or monitoring PR CI in this…

    769 GitHub stars~557 tokensUpdated today
    Auto-check passed
  • Trailsnap Agent

    LC044/TrailSnap

    Query a user's TrailSnap photo library through scoped MCP tools to find photos, reconstruct memories, build person timelines, create evidence-backed narratives, or propose an album plan for explicit…

    769 GitHub stars~445 tokensUpdated today
    Auto-check passed
  • Album Doctor

    LC044/TrailSnap

    对照片库或指定相册进行体检,并把结构、时间、地点、AI 元数据与安全清理问题转成可选择、可确认、尽量可撤销的计划. An agent skill from LC044/TrailSnap.

    769 GitHub stars~254 tokensUpdated today
    Auto-check passed
  • Memory Detective

    LC044/TrailSnap

    根据模糊的时间、地点、同行人、画面和文字线索找回可能的照片事件,并在用户确认后生成可追溯的回忆故事. An agent skill from LC044/TrailSnap.

    769 GitHub stars~233 tokensUpdated today
    Auto-check passed
  • Person Timeline

    LC044/TrailSnap

    按年份和事件整理指定人物出现过的照片,展示共同经历、成长变化、地点与同行人,并可生成可追溯的人物故事. An agent skill from LC044/TrailSnap.

    769 GitHub stars~200 tokensUpdated today
    Auto-check passed

Questions about Trailsnap CLI

What does Trailsnap CLI do?

Query photos, albums, locations, tags, and people from a TrailSnap instance through its command-line client. Trailsnap CLI is an agent skill from LC044/TrailSnap. Query photos, albums, locations, tags, and people from a TrailSnap instance through its command-line client.

When should I use Trailsnap CLI?

Trailsnap CLI fits situations like: 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.

How do I install Trailsnap CLI in Claude Code?

Run `npx skills add LC044/TrailSnap --skill trailsnap-cli -a claude-code`. Or copy the skill folder (skills/trailsnap-cli in LC044/TrailSnap) into .claude/skills/trailsnap-cli in your project. Claude Code loads it when a task matches its description.

How do I install Trailsnap CLI in Codex?

Run `npx skills add LC044/TrailSnap --skill trailsnap-cli -a codex`. Or copy the skill folder (skills/trailsnap-cli in LC044/TrailSnap) into .agents/skills/trailsnap-cli in your project. Codex loads it when a task matches its description.

Can I use Trailsnap CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add LC044/TrailSnap --skill trailsnap-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/trailsnap-cli, .gemini/skills/trailsnap-cli, .github/skills/trailsnap-cli and .opencode/skills/trailsnap-cli in your project.

What does Trailsnap CLI need to run?

SKILL.md names no scripts, command-line tools or credentials: Trailsnap CLI is instructions for the agent only. Our summary lists: Python 3; A credential in YOUR_API_TOKEN.

Does Trailsnap CLI access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Trailsnap CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Trailsnap CLI use?

Trailsnap CLI is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Trailsnap CLI use?

About 365 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Trailsnap CLI?

Skills that share tags, products or a category with Trailsnap CLI: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and MCP Development (coollabsio/coolify, 63k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Trailsnap CLI?

LC044 (a GitHub user) maintains it in LC044/TrailSnap, which has 769 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 7, 2026.

Source: LC044/TrailSnap on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.