Setup Guide

Get the Pagedrop Skill

Give your AI agent the ability to create shareable web pages from any conversation. Works with any agent that can run shell commands.

What's a Skill?

A skill is a markdown file (SKILL.md) that teaches your AI agent how to use a tool. Point your agent at the Pagedrop skill and it learns to create beautiful, shareable HTML pages from your conversations — architecture docs, PR reviews, dashboards, reports, anything.

Your agent creates a GitHub Gist, and Pagedrop turns it into a live web page with annotations and revision history.

1 Get the Skill File

🚀 Easiest way: Just send this link to your agent and it'll know what to do:

https://github.com/Martian-Engineering/pagedrop

Or grab it manually:

# Clone the repo
git clone https://github.com/Martian-Engineering/pagedrop.git

# Or just grab the skill file directly
curl -o SKILL.md https://raw.githubusercontent.com/Martian-Engineering/pagedrop/main/SKILL.md

2 Add It to Your Agent

How you install the skill depends on your agent. Here are the most common setups:

🦞 OpenClaw

Symlink or copy the skill into your agent's skills directory:

# Symlink (recommended — stays up to date with git pull)
ln -s /path/to/pagedrop/SKILL.md /path/to/your-agent/skills/pagedrop/SKILL.md

# Or copy
cp /path/to/pagedrop/SKILL.md /path/to/your-agent/skills/pagedrop/SKILL.md

OpenClaw automatically discovers skills in the skills/ directory and makes them available to your agent.

🖥️ Claude Code

Add the skill to your project's CLAUDE.md or drop it in the repo:

# Option A: Reference in CLAUDE.md
echo "Read skills/pagedrop/SKILL.md when asked to create a pagedrop." >> CLAUDE.md

# Option B: Just tell Claude about it
# "Read /path/to/pagedrop/SKILL.md — use it to create shareable pages"

🤖 Any Agent with Shell Access

If your agent can run gh CLI commands, it can use Pagedrop. Just paste the skill contents into your system prompt or tell the agent to read it:

# The only hard requirement: gh CLI authenticated
gh auth status

The skill uses gh gist create and gh gist edit — that's it.

3 Prerequisites

Your agent needs two things:

Requirement	Why	Install
GitHub CLI (`gh`)	Creates and updates gists	`brew install gh && gh auth login`
Shell access	Runs `gh` commands and writes temp files	Built into most coding agents

💡 Tip: That's really it. No API keys, no server setup, no build tools. The skill teaches your agent to write HTML, upload it as a gist, and share the pagedrop.ai link.

4 Try It Out

Once the skill is installed, ask your agent:

"Create a pagedrop summarizing our architecture discussion"

"Turn this PR diff into a pagedrop for the team to review"

"Make a pagedrop dashboard showing our current metrics"

Your agent will create a self-contained HTML page, upload it as a gist, and hand you a pagedrop.ai link you can share with anyone.

What Your Agent Learns

The skill teaches your agent to:

Create — Write self-contained HTML with Pico CSS, Mermaid diagrams, Chart.js graphs, syntax highlighting
Publish — Upload as a GitHub Gist with #pagedrop tag
Iterate — Update the same gist to create revisions (not new drops)
Share — Convert gist URLs to pagedrop.ai/g/USER/GIST_ID links
Respond to feedback — Process exported annotation markdown and address each point

Links

📦 Skill repo	github.com/Martian-Engineering/pagedrop
🌐 Pagedrop	pagedrop.ai
🐦 Follow us	x.com/pagedropai