otter-fetch - SKILL.md Agent Skill

name: otter-fetch description: "Fetch Otter.ai transcript data. Sub-skill used by cache-notes and fill-participants when Notes: contains an Otter URL." license: MIT

Otter Fetch

Single place for obtaining Otter.ai transcript data. No direct slash command — other skills invoke this when they encounter an Otter.ai URL (e.g. in Notes: frontmatter).

Usage

This skill has no slash command. It's a sub-skill: /cache-notes and /fill-participants invoke its workflow (and run parse_otter.js) when a meeting's Notes: contains an https://otter.ai/u/... URL.

When to use

cache-notes: When caching a meeting that has https://otter.ai/u/{otid} in Notes: — need callout markdown to embed.
fill-participants: When resolving participants for a meeting that only has Otter links (no Google Doc) — need speaker names from the transcript.

How to get the data

Otter has no public API. Use user-pasted JSON:

Extract otid from the URL: https://otter.ai/u/aBcDeFgHiJkLmNoPqRsT → otid = aBcDeFgHiJkLmNoPqRsT.
Ask the user to copy the JSON response from GET https://otter.ai/forward/api/v1/speech?otid={otid} (e.g. from DevTools → Network while signed in, or from a signed-in request).
User pastes the JSON; the agent (or script) parses it.

Outputs (same JSON, different consumers)

The pasted JSON has speech with:

Use case	What to use	How
cache-notes	Callout markdown	Run `parse_otter.js` with JSON on stdin → stdout is `## 🤖 AI Notes` / `### Otter` block with `[!otter_notes]-`, `[!otter_todos]-`, `[!otter_transcript]-`.
fill-participants	Speaker names	From `speech.speakers`: array of `{ speaker_name }`. Use those names with people-resolver to build `Participants:`.

So one paste can serve both skills if needed (e.g. cache-notes runs the script; fill-participants reads speech.speakers from the same JSON or from the cached transcript callout).

Script: parse_otter.js

In this folder: parse_otter.js reads the full Otter speech JSON from stdin and writes callout markdown to stdout (for cache-notes).

node .agents/skills/otter-fetch/parse_otter.js < pasted.json

Output is the exact block to append under ## 🤖 AI Notes (including ### Otter and the three callouts). Caller appends it to the note and sets NotesCached:.

Important notes

Always extract otid from the share URL (query params like ?utm_source=copy_url can be ignored).
If the user doesn't have the JSON, they can open the Otter meeting page while signed in, open DevTools → Network, reload, and copy the response body of the speech?otid=... request.