Skip to content

bickov/slimsnap-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

slimsnap-skill

A Claude Code skill for SlimSnap. Lets Claude Code automatically read structured JSON captures of your screen, so you can say "fix this layout" instead of pasting a screenshot every turn.

About 700 tokens per capture vs the API per-image cap of 1,568 tokens on Sonnet/Haiku (up to 4,784 on Opus 4.7+ per Anthropic's vision docs). Structured bounding boxes, extracted colors, OCR text, and your annotations.

Install

Globally, available in every project:

mkdir -p ~/.claude/skills/slimsnap
curl -L https://raw.githubusercontent.com/bickov/slimsnap-skill/main/SKILL.md \
  -o ~/.claude/skills/slimsnap/SKILL.md

Or scoped to a single project:

mkdir -p .claude/skills/slimsnap
curl -L https://raw.githubusercontent.com/bickov/slimsnap-skill/main/SKILL.md \
  -o .claude/skills/slimsnap/SKILL.md

Use

  1. Launch SlimSnap at least once so it publishes its config to ~/.slimsnap/config.json.
  2. Capture a screenshot with SlimSnap (⌘⇧S).
  3. Annotate what matters: arrows, rectangles, callouts.
  4. Hit Save JSON (autosave on by default writes straight to your configured folder).
  5. In Claude Code, say what you want: "fix the broken sign-up layout I just captured."
  6. Claude Code reads the latest JSON automatically and acts on it.

Why

Pasting a raw screenshot to a coding agent costs hundreds to thousands of vision tokens per turn and the agent re-interprets pixels every time. A SlimSnap JSON costs about 700 tokens, is structured (the agent acts on coordinates), and is reusable across turns without re-paying the cost. Over a long Claude Code session, the difference in context and token spend is real.

How discovery works

The skill is not hardcoded to a specific folder. SlimSnap publishes a tiny config at ~/.slimsnap/config.json naming its current default save folder. The skill reads that file on every invocation and looks in whatever folder you have configured in the SlimSnap Settings window. Change the folder in SlimSnap and the skill follows.

If you prefer keeping captures with a codebase, create a <project>/.slimsnap/ folder and the skill will prefer it when present.

Spec

The JSON format is an open MIT spec: https://github.com/bickov/slimsnap-schema

License

MIT.

About

Claude Code skill that loads the latest SlimSnap JSON capture into your agent's context. Auto-discovers the save folder via ~/.slimsnap/config.json. MIT.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors