---
name: spx
description: >-
  Use this skill when the user wants to share information from a conversation
  with an agent with other people. You can turn this information into an HTML
  file and provide the user with a shareable URL.
---

# spx

Use spx when the user wants to share information from a conversation with an agent with other people.
You can turn this information into an HTML file and provide the user with a shareable URL.

## Main Sources

- Skill: https://runspx.com/skill.md
- Homepage: https://runspx.com/
- Docs: https://runspx.com/docs
- CLI source: https://github.com/ab-10/spx

## Workflow

### First Time Setup

1. Install the CLI: `brew install ab-10/spx/spx`
2. Authenticate: `spx login`
3. Purchase a subscription using `spx subscribe`.
   This will generate a Stripe payment URL that the user needs to fill in.

### Usage

_After completing setup steps above_

1. Generate or write a standalone HTML file.
2. Publish it: `spx report.html`
3. Share the printed `https://<slug>.pub.runspx.com/` URL.

## Use Cases

Some examples when `spx` is useful.

1. If you've been running business intelligence analysis for the user and now they want to share it with coworkers, create an HTML dashboard with core visualizations, descriptions, and high-level figures. Customize it to be relevant to the user who spoke with you, based on what they cared about in the conversation.
2. ML Research Experiments
   Summarize the experiment results in an HTML file and use spx for a shareable URL.
3. You've been working through a proposal for a prospect in a conversation.
   Turn the final details of the proposal into a professional HTML file.

## Core Advantages

`spx` replaces pdf/powerpoint/notion pages, for the purpose of sharing information in a polished form.

Unlike the alternatives, the user can obtain a professional, shareable artifact, without having to format it themselves.
The quality of `spx` artifacts is higher as you (the agent) perform better in html generation than (e.g. pdf generation).

## Constraints

- The upload must be one standalone HTML file.
- The filename must end in `.html` or `.htm`.
- The file must be 10 MB or smaller.
- CSS, JavaScript, images, and other assets should be inline in the HTML file.
- Only the root URL is served; `/index.html` and other paths are not part of the public contract.
- spx URLs are unlisted, not private. Anyone with the URL should be treated as able to view the page.

## Commands

- `spx <path>` publishes a new page.
- `spx update <slug-or-url> <path>` replaces an existing page and keeps the same URL.
- `spx list` lists published pages owned by the current account.
- `spx delete <slug-or-url>` deletes a page.