SLIDESHOT [docs] Markdown
For agents: read the markdown version of these docs →

Install skills

A Slideshot skill is a plain-markdown instruction set that teaches an AI agent how to plan a Slideshot recording: when to ask for credentials, which run options to set for a given audience, and how to handle runs that pause for OTP input. Skills are open source and live in github.com/slideshot/skills.

What a skill does

  • Encodes safe defaults for auth, video, artifacts, and intro run options.
  • Describes the run lifecycle (queued, running, awaiting_input, succeeded, failed, cancelled) and how the agent should react in each state.
  • Provides task templates for common product marketing workflows: launch videos, changelog walkthroughs, docs refreshes, and social clips.
  • Documents the exact tool or endpoint shape the agent should call so it does not invent option names.

You can install a skill in any agent that loads instruction files, system prompts, or rules.

The skills repo ships an npx-friendly installer that supports every common agent runtime. Run it once and pick the skill you want plus the agent you are targeting:

npx skills install slideshot

The installer detects supported agents in your environment (Claude Code, Codex, Cursor, etc.), asks where to install, and drops the skill into the right location. Re-run the same command to update to the latest version.

See the README at github.com/slideshot/skills for the full list of supported agents and flags.

Manual install from GitHub

If you would rather inspect the skill first or wire it into your own tooling, clone the repo and copy the skill directory into wherever your agent loads instructions:

git clone https://github.com/slideshot/skills.git

Then point your agent at skills/slideshot/SKILL.md. The skill is intentionally plain markdown and does not depend on any agent-specific runtime, so any tool that accepts an instruction file works.

A few common locations:

  • Claude Code: copy into ~/.claude/skills/slideshot/.
  • Codex: copy into ~/.config/codex/skills/slideshot/.
  • Cursor: copy into .cursor/rules/slideshot.md (project) or the global rules pane.
  • ChatGPT (Projects / Custom GPT): paste the contents of SKILL.md into the system instructions.

Updating a skill

Re-run the installer to pick up the latest version:

npx skills install slideshot

For the manual path, pull the repo and re-copy the skill directory:

cd skills && git pull

Contributing

The skills repo is open source. To propose a new skill or improve an existing one:

Skills should stay focused: one job per skill, written so an agent that has never used Slideshot before can follow it without guessing.