Agent skill

Trailsnap Agent

by LC044 in 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…

AGPL-3.0Auto-check passed

Install Trailsnap Agent

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

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

GitHub CLI
$ gh skill install LC044/TrailSnap trailsnap-agent --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-agent .claude/skills/trailsnap-agent && 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-agent
GitHub stars
769
Token cost
~445 tokens
SKILL.md length
192 words
Files
2 (incl. references)
Skills in repo
10
Repo updated
First seen
Licence
AGPL-3.0

At a glance

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…

  • The users own TrailSnap library
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Never claim a proposal was executed
  • Changed the library

What it does

Trailsnap Agent is an agent skill from 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 in-app approval. Use for the user's own TrailSnap library; never claim a proposal was executed or changed the library.

Its SKILL.md is about 450 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/workflows.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

  • The users own TrailSnap library
  • Never claim a proposal was executed
  • Changed the library

Example prompts

  • “/trailsnap-agent”

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.

    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 Agent loads about 445 tokens when it runs, and up to ~894 if it reads all its reference files. Until then it costs about 83 tokens; SKILL.md has 192 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~445
With references · SKILL.md plus every file in references/, read only if the agent opens them
~894

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). 192 words, ~445 tokens.

Download SKILL.mdSave it as .claude/skills/trailsnap-agent/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
trailsnap-agent
description
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 in-app approval. Use for the user's own TrailSnap library; never claim a proposal was executed or changed the library.

TrailSnap Agent

Use the trailsnap_* tools supplied by the TrailSnap Pi extension. Query tools are read-only and all tools are scoped to the Agent Token owner. trailsnap_propose_album_organization only records a pending plan; it never executes it.

  • Start with the narrowest tool that answers the request. Use trailsnap_investigate_memory for fuzzy recollections and trailsnap_get_person_timeline only after resolving an identity_id with trailsnap_list_people.
  • Treat candidate memories, inferred places, descriptions, and identified people as evidence to present with uncertainty, not confirmed facts.
  • Paginate when the first result says more data is available. Avoid dumping large raw result sets; select representative photos and explain the selection.
  • Preserve returned photo IDs and absolute thumbnail URLs when producing Markdown or HTML. Never invent a media URL or expose a local file path.
  • Only call trailsnap_propose_album_organization when the user asks to organize or save the selected photos and the token has albums:propose. Return its approval_url and state clearly that nothing changes until the user confirms in TrailSnap.
  • Never attempt to execute or approve a plan. Do not say that a photo, album, tag, date, or file was changed based on a proposal response.

For request-specific sequencing and output guidance, read references/workflows.md.

© 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 1 other file (references) in skills/trailsnap-agent of LC044/TrailSnap.

  • SKILL.md
  • references/workflows.md

Open the folder on GitHubat commit 9d4b63e

Compare with similar skills

Trailsnap Agent 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 Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Trailsnap Agent this skillLC044/TrailSnap769—~445Automated safety check: PassAGPL-3.0
Photoscodewhale-hq/Codewhale41k—~386Automated safety check: PassMIT
Mem0 Memory Scopemem0ai/mem067k—~1.1kAutomated safety check: PassApache-2.0
Adding API ScopesPostHog/posthog40k—~2.1kAutomated safety check: PassCustom licence
AI Photo Restylersickn33/agentic-awesome-skills47k1 repos~3.1kAutomated safety check: PassMIT-0
Scopesuboss87/FDEOps954—~339Automated safety check: PassMIT

Similar skills

  • Photos

    codewhale-hq/Codewhale

    Search a local macOS Photos library and export selected copies when the user asks to find or use their own photos.

    41k GitHub stars~386 tokensUpdated today
    Auto-check passed
  • Shows or changes the default Mem0 memory scope, project, session or global, which decides where memories are saved and searched.

    67k GitHub stars~1.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Adding API Scopes

    PostHog/posthog

    Official

    Guidance for adding an API scope object to posthog/scopes.py and making it work for personal API keys, OAuth tokens and MCP clients.

    40k GitHub stars~2.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • AI Photo Restyler

    sickn33/agentic-awesome-skills

    Install and use the official Photo to Anime package, pinned by digest, for paid hosted work on the Beatra service.

    47k GitHub starsUsed in 1 repo~3.1k tokens
    Auto-check passed
  • Scope

    suboss87/FDEOps

    Assess a new customer request against agreed scope, trade-offs and ownership.

    954 GitHub stars~339 tokensUpdated today
    Auto-check passed
  • Scope Creep Check

    Donchitos/Claude-Code-Game-Studios

    Compares the current state of a feature, sprint or milestone with its original plan, flags added scope, quantifies the growth and recommends cuts.

    26k GitHub stars~1.6k tokensUpdated 9 days ago
    Product & Project ManagementAuto-check passed

More from LC044/TrailSnap

All 10 skills in this repo
  • Trailsnap CLI

    LC044/TrailSnap

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

    769 GitHub starsUsed in 1 repo~365 tokens
    Auto-check passed
  • Release Publisher

    LC044/TrailSnap

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

    769 GitHub stars~1.6k tokensUpdated yesterday
    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 yesterday
    Auto-check passed
  • Album Doctor

    LC044/TrailSnap

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

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

    LC044/TrailSnap

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

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

    LC044/TrailSnap

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

    769 GitHub stars~200 tokensUpdated yesterday
    Auto-check passed

Questions about Trailsnap Agent

What does Trailsnap Agent do?

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…. Trailsnap Agent is an agent skill from 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 in-app approval.

When should I use Trailsnap Agent?

Trailsnap Agent fits situations like: the users own TrailSnap library; never claim a proposal was executed; changed the library.

How do I install Trailsnap Agent in Claude Code?

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

How do I install Trailsnap Agent in Codex?

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

Can I use Trailsnap Agent 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-agent -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-agent, .gemini/skills/trailsnap-agent, .github/skills/trailsnap-agent and .opencode/skills/trailsnap-agent in your project.

What does Trailsnap Agent need to run?

SKILL.md names no scripts, command-line tools or credentials: Trailsnap Agent is instructions for the agent only.

Does Trailsnap Agent 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 Agent 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 Agent use?

Trailsnap Agent 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 Agent use?

About 445 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 449 tokens, read only when the agent opens those files.

What are the alternatives to Trailsnap Agent?

Skills that share tags, products or a category with Trailsnap Agent: Photos (codewhale-hq/Codewhale, 41k stars), Mem0 Memory Scope (mem0ai/mem0, 67k stars), Adding API Scopes (PostHog/posthog, 40k stars) and AI Photo Restyler (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Trailsnap Agent?

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.