Agent Skill

We publish the Savee Public API as an Agent Skill so you can drop it into Claude, Cursor, or any agent that supports the format and have it read your Savee data without writing client code.

What it does

The skill teaches the agent four things:

• The base URL is https://api.savee.com/v1/ and the live schema lives at /v1/openapi.json.
• Authentication is Authorization: Bearer sv_live_… using a token generated in your Savee settings.
• When to reach for the API — intents like "fetch my latest saves", "show my feed", "list my boards".
• Two worked example flows (latest saves, home feed) the agent can pattern-match on.

The skill itself does not contain credentials or a snapshot of the API spec — it points at the live OpenAPI document so it stays accurate as the API evolves.

Install

The skill is hosted at github.com/saveeit/skills under skills/api/. Install it via skills.sh:

npx skills add https://github.com/saveeit/skills --skill api

Then make your token available to the agent as the environment variable SAVEE_TOKEN (generate one at savee.com/settings/ → API Access).

Once installed, the agent picks the skill up automatically when you ask it something that matches the intents above — no need to invoke it explicitly.

Try it

Once installed, prompts like these should activate the skill:

• "Fetch the latest 10 saves from my Savee account and summarize them."
• "Pull my Savee feed and group the saves by who posted them."
• "List my Savee boards and show how many saves each one has."

If the agent doesn't know where to look, point it at the skill or remind it that the API lives at api.savee.com.