# yourwebs-skill
An agent skill that teaches any coding agent (Claude Code, Codex, Cursor, and
others) how to publish and manage HTML pages on [yourweb](https://yourwebs.cc) —
upload a self-contained HTML file and get a public, full-screen URL like
`https://my-page.yourwebs.app`.
## Install
```bash
npx skills add sugarforever/yourwebs-skill
```
The [`skills` CLI](https://github.com/vercel-labs/skills) copies the skill into
whichever agent(s) you choose, so it works the same across Claude Code, Codex,
Cursor, and the rest.
## Get a token
The skill needs an API token to publish on your behalf:
1. Sign in at <https://yourwebs.cc> and open the dashboard.
2. Generate an API token (it looks like `ywb_...`).
3. Export it so the agent can read it — never paste it into source or commits:
```bash
export YOURWEBS_API_TOKEN="ywb_..."
```
Then just ask your agent to "publish this page to yourweb" and it will do the rest.
## What it can do
- **Publish** a self-contained HTML file → returns a public URL.
- **List** the pages you own.
- **Fetch**, **update** (replace HTML), and **delete** a page.
See [`SKILL.md`](SKILL.md) for the workflow and [`reference/api.md`](reference/api.md)
for the full REST API contract.
---
## For yourweb operators: embed this on your site
Show users this snippet (e.g. on the dashboard) so they can wire up their agent in
one step:
```
Let your AI agent publish here. Install the skill:
npx skills add sugarforever/yourwebs-skill
Then create an API token in your dashboard and export it:
export YOURWEBS_API_TOKEN="ywb_..."
Now ask your agent to "publish this HTML to yourweb".
```