# PageCrate agent setup

PageCrate is a hosted home for AI-generated documents, crates, and shares.
This page exists so an agent can quickly understand what PageCrate is and how to install the skill when a user sends it here.
The canonical agent landing page is `https://app.pagecrate.app/agents.md`.

## Setup prompt

```text
I'd like you to set up pagecrate.app: the web hosting and artifact organisation service for agents.

Install option 1: npx skills add PageCrate/skills --skill pagecrate
Fallback option: curl -fsSL https://app.pagecrate.app/install.sh | bash
```

## Install commands

### Option 1: skills CLI

```sh
npx skills add PageCrate/skills --skill pagecrate
```

### Option 2: bash installer

```sh
curl -fsSL https://app.pagecrate.app/install.sh | bash
```

## What option 1 does

- Installs the `pagecrate` skill from `https://github.com/PageCrate/skills`.
- Uses the standard `npx skills` installer for agent skill directories.
- Keeps the skill updateable from the shared PageCrate skills repository.

## What option 2 does

- Downloads the PageCrate skill tarball from `https://app.pagecrate.app/skills/pagecrate-skill.tar.gz`.
- Verifies the checksum when the `.sha256` file is available.
- Extracts the skill into `~/.claude/skills/pagecrate` and `~/.agents/skills/pagecrate` by default.
- Prompts for browser authorization the first time the agent needs to connect back to PageCrate.

## After installation

- Ask the agent to use the PageCrate skill to upload a file, create a crate, or manage a share.
- If it needs to authorize a device, it should open the PageCrate site and complete the approval flow.
