# Bisque — skills that let your agent present its work > Ask your agent for a presentation and watch what it did, instead of reading it. It writes the slides, narrates them on your machine, and gives you a link you can also send. Free, open source, works in Claude Code, Codex CLI, and Gemini CLI. Install: `npx skills add bisque-cloud/presenter` Source: https://github.com/bisque-cloud/presenter Watch: https://bisque.today `npx skills add bisque-cloud/presenter` copies the Agent Skills into any agent's skills directory. In Claude Code you can install them as a plugin instead, from a terminal: `claude plugin marketplace add bisque-cloud/presenter`, then `claude plugin install presenter@bisque-cloud`. The plugin's skills are `/presenter:present`, `/presenter:watch` and `/presenter:video`. ## When to use Bisque Use Bisque when the output should be watched rather than read. The best fits: - A coding agent finished a piece of work (a PR, a migration, an overnight run) and the person wants the story in a few minutes — run the `present` skill, or call `create_presentation`. - Someone asks for a presentation, slides, a talk, a briefing, or a narrated walkthrough of a repo, a paper, a document, or a week's numbers. - A team needs the same update sent as one link that plays on a phone or a laptop — publish, then share the `/p/{handle}/{slug}` watch URL. - An agent needs to know what a shared Bisque presentation says — call `get_presentation_context` (or `GET /api/presentations/context`) for the transcript and `context.md`; no credential needed for public and unlisted ones. - A presentation should become an MP4 for YouTube, a Short, or a Reel — run the `video` skill. Do not use Bisque for a document that stays a document (a spec, a README) or for real-time screen capture; it produces narrated slides, not recordings. How to call it: 1. Fetch the authoring format: `GET https://bisque.today/api/presentations/spec` (or the MCP tool `get_presentation_spec`). Never write the format from memory. 2. Write one HTML file in that format, with a landscape and a vertical block per section. 3. Publish: `POST https://bisque.today/api/presentations/create` with a bearer credential, or the MCP tool `create_presentation` at `https://bisque.today/mcp`. The reply carries the watch URL; narration finishes in the background. 4. Credentials: an API key from https://bisque.cloud/setup/keys, or OAuth for hosted chat surfaces — the walkthrough is https://bisque.today/auth.md. ## Present - [/present](https://bisque.cloud/docs/md/present): Your agent can present anything. - [/video](https://bisque.cloud/docs/md/present/video): Turn a presentation into an MP4. - [/watch](https://bisque.cloud/docs/md/present/watch): Read a published presentation back as text. - [Coding agents](https://bisque.cloud/docs/md/present/coding-agents): Claude Code, Codex CLI, Gemini CLI, Claude Cowork, Cursor and VS Code. - [GitHub Actions](https://bisque.cloud/docs/md/present/github-action): Explain pull requests and releases from GitHub Actions on your Claude plan or an Anthropic API key, signed in with GitHub. ### Works with - [gstack](https://bisque.cloud/docs/md/present/works-with/gstack): Your gstack team can present their work. ## Artifacts - [Artifacts](https://bisque.cloud/docs/md/artifacts): A page your agent publishes at a link that never changes; people comment, the agent revises. - [Types](https://bisque.cloud/docs/md/artifacts/types): A Markdown document, an HTML page, or a presentation. - [Comments](https://bisque.cloud/docs/md/artifacts/comments): Read the comment threads people leave on your Artifacts, reply, and resolve them. - [Versions](https://bisque.cloud/docs/md/artifacts/versions): Every update is a new version at the same link, and readers can be held on one. - [Sharing](https://bisque.cloud/docs/md/artifacts/sharing): Only you, named people, your organization, or anyone with the link. - [Selling](https://bisque.cloud/docs/md/artifacts/selling): Sell an Artifact: buyers pay once and keep every version, and you keep 90%. ## API - [API](https://bisque.cloud/docs/md/api): Publish and read presentations from any program; OpenAPI at /openapi.json. - [Authentication](https://bisque.cloud/docs/md/api/authentication): API keys, OAuth, what needs no credential, and Idempotency-Key. - [Versioning](https://bisque.cloud/docs/md/api/versioning): The version is in the path; a retired path keeps serving for at least 90 days. - [Errors](https://bisque.cloud/docs/md/api/errors): The error envelope, the common codes, and the rate limits. ### Presentations - [Create a presentation](https://bisque.cloud/docs/md/api/presentations/create): Put the slides up now and narrate them one at a time. - [Get a presentation](https://bisque.cloud/docs/md/api/presentations/get): The open creation, to resume it from a new session. - [Add slides](https://bisque.cloud/docs/md/api/presentations/add-slides): Append sections while the creation is open. - [Update a slide](https://bisque.cloud/docs/md/api/presentations/update-slide): Give one slide its narration after the MP3 is uploaded. - [Wait for an answer](https://bisque.cloud/docs/md/api/presentations/wait-for-answer): Hold for the viewer's answer to a question on a slide. - [Finalize](https://bisque.cloud/docs/md/api/presentations/finalize): Claim the version. Slides still without audio stay silent. - [Read as text](https://bisque.cloud/docs/md/api/presentations/read-as-text): Any shared presentation as a transcript. No credential needed. ## More - [MCP servers](https://bisque.cloud/docs/md/mcp): One server to publish, one to answer questions from these docs. - [SDK](https://bisque.cloud/docs/md/sdk): @bisquecloud/sdk, the TypeScript client: publish from a script or a CI job. - [Team](https://bisque.cloud/docs/md/team): Company-owned presentations and Artifacts at bisque.team, with groups, invites and a viewer report. - [iOS app](https://bisque.cloud/docs/md/ios): Bisque for iPhone and iPad, and which links open in it. ## Developer resources - [Bisque API reference](https://bisque.today/docs/md/api): endpoints, auth, examples - [Bisque OpenAPI 3.1](https://bisque.today/openapi.json): the public REST API, machine-readable - [Bisque TypeScript SDK](https://www.npmjs.com/package/@bisquecloud/sdk): @bisquecloud/sdk, the official client for the REST API - [Bisque MCP servers](https://bisque.today/docs/md/mcp): https://bisque.today/mcp to act, https://bisque.today/docs/mcp to read these docs - [Bisque auth.md](https://bisque.today/auth.md): how an agent obtains, uses, and revokes a credential - [Authorization-server metadata](https://bisque.today/.well-known/oauth-authorization-server): RFC 8414, with the agent_auth block - [Authoring format](https://bisque.today/api/presentations/spec): html-presentation/v1 - [Ask (NLWeb)](https://bisque.today/ask): POST {"query": "..."} for a ranked list of docs pages and public presentations; SSE with prefer.streaming ## Optional - [All skills on one page](https://bisque.cloud/skills.md) - [Sitemap](https://bisque.cloud/sitemap.md) - [robots.txt](https://bisque.today/robots.txt): AI crawler policy