# 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

## 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.

## Skills

- [/present](https://bisque.cloud/docs/md/present): Your agent can present anything.
- [/video](https://bisque.cloud/docs/md/video): Turn a presentation into an MP4.

## Works with

- [gstack](https://bisque.cloud/docs/md/gstack): Your gstack team can present their work.

## Build on Bisque

- [API](https://bisque.cloud/docs/md/api): Publish and read presentations from any program; OpenAPI at /openapi.json.
- [MCP servers](https://bisque.cloud/docs/md/mcp): One server to publish, one to answer questions from these docs.

## 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 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

## 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