# 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`](https://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.

## Install with `npx skills` (recommended)

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:

```bash
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`](https://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:

```bash
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:

```bash
npx skills install slideshot
```

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

```bash
cd skills && git pull
```

## Contributing

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

- Open an issue at [`github.com/slideshot/skills/issues`](https://github.com/slideshot/skills/issues).
- Submit a pull request for new task templates, defaults, or agent runtime support.

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