> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polysh.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skills

> Let Claude Code, Codex, Cursor and other coding agents record a narrated demo of your web app into Polysh.

## Overview

Polysh publishes one skill, `polysh-agent-recorder`. With it, your coding agent records a narrated demo, walkthrough or how-to video of your own web app. It explores the app, writes a short storyboard of what to show and say, rehearses it, then records it in a browser window on your computer. The video arrives in your Polysh workspace, where Polysh adds the voice, zooms and translations.

It works with Claude Code, Codex, Cursor and any other coding agent that supports the skills CLI.

## Before you start

* A Polysh workspace you can sign in to. Workspaces are by invitation.
* Node 22 or newer on your computer.
* Your app open in a browser on your computer: a live site or one running locally.

## Install

**1. Add the skill**

From any folder, or the one with your app's code:

```bash theme={null}
npx skills add https://docs.polysh.io
```

That installs `polysh-agent-recorder` for your coding agent.

**2. Ask for a video**

Start a new session with your agent and ask, for example: *"Make a Polysh demo video of how a user creates an invoice."*

**3. Say yes to the install**

The first time, the agent asks once before it installs the Polysh recorder and the browser it drives (about 150 MB). Recording also needs FFmpeg; if it is missing, the agent tells you how to install it and asks before doing so.

**4. Approve the sign-in**

The agent opens Polysh in your browser with a code. Check the code and approve. Your computer then appears in **Workspace settings**, **Connected apps**.

> [!TIP]
>
> Prefer to install it yourself? Run `npm i -g @polysh/agent-recorder@latest`, then `polysh-agent setup`, `polysh-agent skill install` and `polysh-agent connect`.

## What the agent asks you

* Up to three questions in one message, only about what your request left open: whether it may read your app's code, which demo account or record it may change, and the address or flow if you didn't name them.
* To sign in to your app yourself, in a window it opens. It never needs your password. Close that window when you are done.
* Before it records and uploads. In approve-first mode it also shows you the storyboard and the rehearsal screenshots.
* Before it pays, deletes, or changes a setting your live customers use.
* After upload, before it marks the narration reviewed, changes export settings, or exports.

> [!NOTE]
>
> Use a demo account and sample data. The video shows exactly what is on screen.

## Update

Installed skills don't update on their own. Run `npx skills update -y`, or re-run the add command. The agent updates the recorder itself when Polysh says it is too old.

## Sign out

Choose **Sign out** next to the computer in **Workspace settings**, **Connected apps**, or run `polysh-agent disconnect` on that computer.

## Common Questions

> [accordion] Where does the video go?
>
> To your Private area in Polysh, where only you and workspace admins can see it. Nothing is shared automatically.

> [accordion] Can it record an app that only runs on my computer?
>
> Yes. The browser runs on your computer, so it can open your app on a local address as well as a live site.

> [accordion] Can I keep using my computer while it records?
>
> Leave the recording window visible and don't click in it. You can use other windows.

> [accordion] Which agents does it work with?
>
> Any coding agent that can run commands and supports the skills CLI, such as Claude Code, Codex and Cursor.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.