Agent skill

Paperclip Page

by paperclipai in paperclipai/paperclip

Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host.

MITAuto-check passedFrontend & Design

Install Paperclip Page

skills CLI
$ npx skills add paperclipai/paperclip --skill paperclip-page -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install paperclipai/paperclip paperclip-page --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/paperclipai/paperclip.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/paperclip-page .claude/skills/paperclip-page && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
paperclip-page
GitHub stars
100k
Token cost
~1k tokens
SKILL.md length
481 words
Files
4 (incl. scripts)
Skills in repo
60
Repo updated
First seen
Licence
MIT

At a glance

Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host.

  • Works in 5 steps: Inspect the source directory and confirm… → Run scripts/publish.sh --dry-run to… → Choose a slug → …
  • Asked to deploy
  • SKILL.md covers Requirements, Workflow, Update Workflow and Safety Rules, plus 1 more section
  • Runs Shell and JavaScript scripts from its folder; calls aws; reaches pages.paperclip.ing; needs PAPERCLIP_PAGE_AWS_ACCESS_KEY_ID and PAPERCLIP_PAGE_AWS_SECRET_ACCESS_KEY

What it does

Paperclip Page is an agent skill from paperclipai/paperclip. Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host. Use when asked to deploy, host, or share a persistent page, viewer, prototype, report, or static site without here.now.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `README.md` and `scripts/publish.sh`).

It sits in Frontend & Design, covering File uploads and storage, HTML artifacts and Static sites and blogs. It works with Amazon Web Services. The repository describes itself as: The open-source app everyone uses to manage agents at work. The licence is MIT.

When your agent uses it

  • Asked to deploy
  • Share a persistent page
  • Static site without here.now

Example prompts

  • “/paperclip-page”

Requirements

  • Node.js
  • A Bash shell
  • A credential in PAPERCLIP_PAGE_AWS_SECRET_ACCESS_KEY
  • A credential in PAPERCLIP_PAGE_AWS_SESSION_TOKEN

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Inspect the source directory and confirm it is public static content only.
  2. Run scripts/publish.sh --dry-run to validate local structure and see
  3. Choose a slug
  4. Publish
  5. Return the printed public URL and S3 prefix to the issue/user.

What it can do on your machine

Read from SKILL.md and the folder at commit de9ab8e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Shell and JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • aws

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • pages.paperclip.ing

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • PAPERCLIP_PAGE_AWS_ACCESS_KEY_ID
    • PAPERCLIP_PAGE_AWS_SECRET_ACCESS_KEY
    • PAPERCLIP_PAGE_AWS_SESSION_TOKEN
    • AWS_ACCESS_KEY_ID
    • AWS_SECRET_ACCESS_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Paperclip Page loads about 1k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 481 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from paperclipai/paperclip at commit de9ab8e, republished under its MIT licence (© paperclipai). 481 words, ~1,047 tokens.

Download SKILL.mdSave it as .claude/skills/paperclip-page/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
paperclip-page
description
Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host. Use when asked to deploy, host, or share a persistent page, viewer, prototype, report, or static site without here.now.

Paperclip Page

Use this skill to publish a static directory to the configured Paperclip pages host, for example https://pages.paperclip.ing/<slug>/.

Requirements

  • Source directory contains index.html at its root.
  • aws CLI v2, curl, and jq are available on PATH for live publishes.
  • Environment variables are configured:
    • PAPERCLIP_PAGE_BUCKET
    • PAPERCLIP_PAGE_BASE_URL
    • AWS_REGION
    • PAPERCLIP_PAGE_AWS_ACCESS_KEY_ID and PAPERCLIP_PAGE_AWS_SECRET_ACCESS_KEY with the page-uploader credentials from Paperclip Secrets
  • Optional environment variables:
    • PAPERCLIP_PAGE_DEFAULT_PREFIX
    • PAPERCLIP_PAGE_AWS_PROFILE (alternative to the namespaced key pair)
    • PAPERCLIP_PAGE_AWS_SESSION_TOKEN (only together with the namespaced key pair)

Do not bind the page-uploader credentials as global AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY: static env keys take precedence over AWS_PROFILE in every AWS SDK, so global names silently replace the host identity for every process in the agent run. The namespaced variables scope the uploader identity to this helper only. The ambient credential chain still works as a fallback when none of the PAPERCLIP_PAGE_AWS_* credential variables are set.

Workflow

  1. Inspect the source directory and confirm it is public static content only.
  2. Run scripts/publish.sh <dir> --dry-run to validate local structure and see the resolved URL/prefix.
  3. Choose a slug:
    • Use --slug <slug> when the user gave a stable URL path.
    • Omit --slug to derive one from the source directory name.
  4. Publish:
bash
.agents/skills/paperclip-page/scripts/publish.sh ./site --slug my-page
  1. Return the printed public URL and S3 prefix to the issue/user.

Update Workflow

Updates are additive overwrites only. The helper never deletes remote objects.

bash
.agents/skills/paperclip-page/scripts/publish.sh ./site --slug my-page --update

When the target prefix already exists, --update requires local ownership proof from ./site/.paperclip-page/state.json generated by an earlier publish from that same source directory. Without that state, create a new slug instead of overwriting another page.

Show full SKILL.md (225 more words)Show less

Safety Rules

  • Publish public content only. Do not publish secrets, customer data, private company material, credentials, or internal logs.
  • Never print AWS secret values.
  • Never change bucket policy, IAM, DNS, CloudFront, or ACM settings from this skill. Setup belongs to an operator runbook, not the publish helper.
  • Never upload outside the configured bucket and prefix.
  • Never use aws s3 sync --delete or require s3:DeleteObject in v1.
  • The helper forces --no-follow-symlinks and fails if any source symlink is present.
  • The helper rejects hidden files and dot-segment paths except its own .paperclip-page/state.json.
  • Slugs and prefix segments must use lowercase ASCII letters, digits, and hyphens only.
  • Keep site-wide root objects such as 404.html operator-managed; publishes always target <slug>/... or <default-prefix>/<slug>/....

Troubleshooting

  • Slug already exists: choose a different slug or use --update from the original source directory containing .paperclip-page/state.json.
  • Missing index.html: build the static site first or point the helper at the directory that contains the root HTML file.
  • Found symlink: replace symlinks with real files before publishing.
  • AccessDenied: confirm the uploader IAM policy allows ListBucket, GetObject, and PutObject for the configured bucket/prefix, and that the agent received the Paperclip Secrets.
  • Public URL verification failed: check CloudFront deployment/DNS, object existence, and that the distribution uses HTTPS with the private S3 REST origin.

See README.md next to this skill for operator setup, AWS policy examples, credential rotation, and install/attach commands.

© paperclipai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in .agents/skills/paperclip-page of paperclipai/paperclip.

  • SKILL.md
  • README.md
  • scripts/publish.sh
  • scripts/publish.test.mjs

Open the folder on GitHubat commit de9ab8e

Compare with similar skills

Paperclip Page next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Paperclip Page compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Paperclip Page this skillpaperclipai/paperclip100k—~1kAutomated safety check: PassMIT
Pretty Pagealexknowshtml/claude-skills149—~2.2kAutomated safety check: NotesNone
QA Handoffjoshukraine/dotfiles429—~4.1kAutomated safety check: PassMIT
Create HTMLminorun365/html-share108—~2.1kAutomated safety check: PassApache-2.0
Launch With AWSaws/agent-toolkit-for-aws2.8k—~3.4kAutomated safety check: PassApache-2.0
Octo HTMLMininglamp-OSS/octo-cli918—~4.2kAutomated safety check: PassApache-2.0

Similar skills

  • Pretty Page

    alexknowshtml/claude-skills

    Convert markdown to a beautifully styled, shareable HTML page and upload to S3-compatible storage

    149 GitHub stars~2.2k tokensUpdated 4 mo ago
    Frontend & DesignAuto-check: notes
  • QA Handoff

    joshukraine/dotfiles

    Generate a hands-on QA testing guide as a self-contained HTML page — for Rails apps or static (Hugo) sites.

    429 GitHub stars~4.1k tokensUpdated 5 days ago
    Frontend & DesignAuto-check passed
  • Create HTML

    minorun365/html-share

    Create a polished, self-contained, responsive HTML briefing from notes, research, comparisons, plans, or reports.

    108 GitHub stars~2.1k tokensUpdated 10 days ago
    Frontend & DesignAuto-check passed
  • Launch With AWS

    aws/agent-toolkit-for-aws

    Official

    Migrates vibe-coded web applications to AWS. An agent skill from aws/agent-toolkit-for-aws.

    2.8k GitHub stars~3.4k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Octo HTML

    Mininglamp-OSS/octo-cli

    HTML docs domain (octo-doc) — create and govern self-contained interactive HTML documents, immutable versions, drafts, sharing, media, comments, and agent element edits.

    918 GitHub stars~4.2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Implementing Drag Drop

    ancoleman/ai-design-components

    Implements drag-and-drop and sortable interfaces with React/TypeScript including kanban boards, sortable lists, file uploads, and reorderable grids.

    525 GitHub stars~1.8k tokensUpdated 10 mo ago
    Frontend & DesignAuto-check passed

More from paperclipai/paperclip

All 60 skills in this repo
  • Garden Inbox

    paperclipai/paperclip

    Scan a Paperclip user's Mine inbox, classify reversible archive candidates, request checkbox confirmation, and archive only accepted selections.

    100k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Paperclip

    paperclipai/paperclip

    Interact with the Paperclip control plane API for task coordination and governance.

    100k GitHub stars~9.6k tokensUpdated today
    Auto-check passed
  • Paperclip

    paperclipai/paperclip

    A skill your agent uses for Paperclip-managed tasks and heartbeats: reading task context, delivering task documents or files, updating completion or blockers, coordinating or delegating work, and…

    100k GitHub stars~18k tokensUpdated today
    Auto-check passed
  • Design Guide

    paperclipai/paperclip

    Paperclip UI design system guide for building consistent, reusable frontend components.

    100k GitHub starsUsed in 1 repo~3.1k tokens
    Auto-check passed
  • Paperclip Create Agent

    paperclipai/paperclip

    Create new agents in Paperclip with governance-aware hiring.

    100k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Wireframe

    paperclipai/paperclip

    Produce low-fidelity black-and-white UI wireframes as SVGs or viewer pages.

    100k GitHub stars~2.9k tokensUpdated today
    Auto-check passed

Questions about Paperclip Page

What does Paperclip Page do?

Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host. Paperclip Page is an agent skill from paperclipai/paperclip. Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host.

When should I use Paperclip Page?

Paperclip Page fits situations like: asked to deploy; share a persistent page; static site without here.now.

How do I install Paperclip Page in Claude Code?

Run `npx skills add paperclipai/paperclip --skill paperclip-page -a claude-code`. Or copy the skill folder (.agents/skills/paperclip-page in paperclipai/paperclip) into .claude/skills/paperclip-page in your project. Claude Code loads it when a task matches its description.

How do I install Paperclip Page in Codex?

Run `npx skills add paperclipai/paperclip --skill paperclip-page -a codex`. Or copy the skill folder (.agents/skills/paperclip-page in paperclipai/paperclip) into .agents/skills/paperclip-page in your project. Codex loads it when a task matches its description.

Can I use Paperclip Page in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add paperclipai/paperclip --skill paperclip-page -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/paperclip-page, .gemini/skills/paperclip-page, .github/skills/paperclip-page and .opencode/skills/paperclip-page in your project.

What does Paperclip Page need to run?

Going by SKILL.md and its folder, Paperclip Page needs a shell and JavaScript for the scripts in its folder, the command-line tools its instructions call (aws) and credentials named PAPERCLIP_PAGE_AWS_ACCESS_KEY_ID, PAPERCLIP_PAGE_AWS_SECRET_ACCESS_KEY, PAPERCLIP_PAGE_AWS_SESSION_TOKEN and AWS_ACCESS_KEY_ID. Our summary lists: Node.js; A Bash shell; A credential in PAPERCLIP_PAGE_AWS_SECRET_ACCESS_KEY; A credential in PAPERCLIP_PAGE_AWS_SESSION_TOKEN.

Does Paperclip Page access the network?

SKILL.md names 1 domain. In commands or code: pages.paperclip.ing; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Paperclip Page safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Paperclip Page use?

Paperclip Page is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Paperclip Page use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Paperclip Page?

Skills that share tags, products or a category with Paperclip Page: Pretty Page (alexknowshtml/claude-skills, 149 stars), QA Handoff (joshukraine/dotfiles, 429 stars), Create HTML (minorun365/html-share, 108 stars) and Launch With AWS (aws/agent-toolkit-for-aws, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Paperclip Page?

paperclipai (a GitHub organization) maintains it in paperclipai/paperclip, which has 99,905 GitHub stars. The repository holds 60 skills in this directory. The repository was last updated on October 11, 2026.

Source: paperclipai/paperclip on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.