The DemoTake skill
One SKILL.md file teaches your agent how DemoTake works, from planning scenes to exporting a checked video. Install it once and your agent stops guessing which tool comes next.
Connecting DemoTake gives your agent the tools. The skill gives it the playbook: which tool to call first, when a scene should end, how to retry just one scene, and how to export something you can ship. Agents that load it make fewer wrong turns and ask you fewer questions.
The skill is a single Markdown file at https://demotake.my/skills/demotake/SKILL.md. The Agents page has it too, with Copy and Download buttons.
Install it in Claude Code
Claude Code loads skills from a skills folder, either for you or for one project:
| Scope | Path |
|---|---|
| Every project on your Mac | ~/.claude/skills/demotake/SKILL.md |
| One project (commit it for your team) | .claude/skills/demotake/SKILL.md in the project |
Download it straight into place:
$ mkdir -p ~/.claude/skills/demotake $ curl -fsSL -o ~/.claude/skills/demotake/SKILL.md https://demotake.my/skills/demotake/SKILL.md $ ls ~/.claude/skills/demotake SKILL.md
.claude/skills/demotake inside the project instead.mkdir -p ~/.claude/skills/demotake
curl -fsSL -o ~/.claude/skills/demotake/SKILL.md https://demotake.my/skills/demotake/SKILL.mdStart a new Claude Code session afterwards so it loads the skill.
Install it in other agents
- Agents with skills folders: put
SKILL.mdwherever your agent loads skills from, in a folder nameddemotake. - Agents with instruction files: paste the contents into
AGENTS.md, your editor's rules file, or the project instructions your agent reads at the start of a session. - Any language model: point it at
/llms.txt, a plain-text map of every docs page, tool and API endpoint, or at/llms-full.txt, all of the docs in one file for agents that prefer to load everything up front.
The skill doesn't replace the MCP connection. Set that up first in Connect your agent.
What the skill teaches
The heart of the skill is the recording loop. Every call names its handles (take_…, scn_…), so the agent always knows which take and scene it's working on.
- permissions_status
- targets_list
- take_createwith scenes
- capture_start
- take_start_sceneper scene
- act
- assert_*
- take_checkpoint
- capture_stop
- edit_suggest_cuts
- edit_apply
- export_renderwait: true
- export_validate
- share
In words:
- Check permissions and find the app.
permissions_statusfirst, thentargets_listto pick the window (or a booted iOS Simulator device). - Plan scenes.
take_createwith a goal and three to six scenes, each a story beat that ends at a stable screen: "Sign in", "Create project", "Export". - Record scene by scene.
capture_start, then for each scenetake_start_scene, do the steps, prove the result withassert_textorassert_element, and end withtake_checkpointdescribing the stable state. If a scene goes wrong,take_retry_scenere-records that scene only. - Tighten the cut.
capture_stop, thenedit_suggest_cutsto review long still stretches (consent and result screens are protected), and apply the reviewed plan withedit_apply. Every edit returns an id thatedit_revertcan undo. - Export and verify.
export_renderwithwait: truerenders the formats you asked for;export_validateconfirms the file opens, has the right length and size, and decodes. - Share the result, or hand you the file paths.
It also covers the "demo as code" loop: take_to_spec saves a finished take as demotake.json, and take_replay with only_changed: true re-records only the scenes whose screens changed after a release. See Demo specs and CI.
For web apps and app reviews it covers recording only the browser page with a drawn address bar (browser, url_contains), handing sign-in and consent to you (take_handoff), leaving slow server work out of the video (take_wait), exports under an upload limit (max_mb) and the platform check (review_check). See Record a platform review video.
And music: music_generate adds instrumental background music (checking the allowance with dry_run before a playlist), music_add uses your own track or lowers the music under narration, and composition_create builds a long-form study-with-me video with a timer, chimes and chapters. See Background music and Make a study-with-me video.
The guide inside the app
DemoTake also explains itself over MCP, so an agent without the skill can still find its way:
- The server's connection instructions summarize the workflow and say which edition is running.
- The
demotake_guidetool returns the full workflow guide from the app itself, tailored to your edition, including browser takes, hand-offs and platform review presets. DemoTake Studio's guide, for example, tells the agent to operate the app with its own tools and report each step withtake_log_event. - The same guide is available as the MCP resource
demotake://guide, and therecord_featureprompt starts a complete "record this feature" request.
If your agent seems unsure, ask it to "call demotake_guide first". It's read-only and cheap.
The guide also covers privacy: mark secret input as secure so it's never logged and is masked in renders. The record_feature prompt adds that agents should never type real secrets you didn't provide. Snapshots an agent receives have detected secrets blurred.
Where to go next
- Connect your agent if you haven't yet.
- MCP tool reference for every tool group, with the full list at /api.
- How a coding agent records a feature demo, a walkthrough of a real session.