Agent skill

Pp Etherpad

by mvanhorn in mvanhorn/printing-press-library

Printing Press CLI for Etherpad. An agent skill from mvanhorn/printing-press-library.

Apache-2.0Auto-check: notes

Install Pp Etherpad

skills CLI
$ npx skills add mvanhorn/printing-press-library --skill pp-etherpad -a claude-code

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

GitHub CLI
$ gh skill install mvanhorn/printing-press-library pp-etherpad --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/mvanhorn/printing-press-library.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-skills/pp-etherpad .claude/skills/pp-etherpad && 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
pp-etherpad
GitHub stars
2.1k
Token cost
~3.3k tokens
SKILL.md length
1,420 words
Files
1
Skills in repo
505
Repo updated
First seen
Licence
Apache-2.0

At a glance

Printing Press CLI for Etherpad. An agent skill from mvanhorn/printing-press-library.

  • Works in 3 steps: Install via the Printing Press… → Verify: etherpad-pp-cli --version → Ensure the reported install directory is…
  • SKILL.md covers Prerequisites: Install the CLI, Command Reference, Auth Setup and Agent Mode, plus 7 more sections
  • Calls claude, npx and go

What it does

Pp Etherpad is an agent skill from mvanhorn/printing-press-library. Printing Press CLI for Etherpad. Etherpad is a real-time collaborative editor scalable to thousands of simultaneous real time users. It provides full...

Its SKILL.md is about 3.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Official library of CLIs generated by the CLI Printing Press. Endorsed, tested, and community-contributed. The licence is Apache-2.0.

Example prompts

  • “/pp-etherpad”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Read, Bash

Workflow steps

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

  1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and…
  2. Verify: etherpad-pp-cli --version
  3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude
    • npx
    • go

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

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Pp Etherpad loads about 3.3k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 1,420 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from mvanhorn/printing-press-library at commit 0fdcc7a, republished under its Apache-2.0 licence (© mvanhorn). 1,420 words, ~3,290 tokens.

Download SKILL.mdSave it as .claude/skills/pp-etherpad/SKILL.md (or your agent's skills folder).
name
pp-etherpad
description
Printing Press CLI for Etherpad. Etherpad is a real-time collaborative editor scalable to thousands of simultaneous real time users. It provides full...
allowed-tools
Read, Bash
author
John McLear
license
Apache-2.0
argument-hint
<command> [args] | install cli|mcp
<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/productivity/etherpad/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Etherpad — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the etherpad-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

  1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:
    bash
    npx -y @mvanhorn/printing-press-library install etherpad --cli-only
  2. Verify: etherpad-pp-cli --version
  3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

bash
go install github.com/mvanhorn/printing-press-library/library/productivity/etherpad/cmd/etherpad-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Command Reference

anonymize-author — Manage anonymize author

  • etherpad-pp-cli anonymize-author — anonymizes an author across all their edits

append-chat-message — Manage append chat message

  • etherpad-pp-cli append-chat-message — appends a chat message

append-text — Manage append text

  • etherpad-pp-cli append-text — appends text to a pad

check-token — Manage check token

  • etherpad-pp-cli check-token — returns ok when the current API token is valid

compact-pad — Manage compact pad

  • etherpad-pp-cli compact-pad — compacts a pad's revision history, keeping recent revisions only

copy-pad — Manage copy pad

  • etherpad-pp-cli copy-pad — copies a pad with full history and chat

copy-pad-without-history — Manage copy pad without history

  • etherpad-pp-cli copy-pad-without-history — copies a pad without history or chat

create-author — Manage create author

  • etherpad-pp-cli create-author — creates a new author

create-author-if-not-exists-for — Manage create author if not exists for

  • etherpad-pp-cli create-author-if-not-exists-for — this functions helps you to map your application author ids to Etherpad author ids

create-diff-html — Manage create diff html

  • etherpad-pp-cli create-diff-html — returns an HTML diff between two revisions of a pad

create-group — Manage create group

  • etherpad-pp-cli create-group — creates a new group

create-group-if-not-exists-for — Manage create group if not exists for

  • etherpad-pp-cli create-group-if-not-exists-for — this functions helps you to map your application group ids to Etherpad group ids

create-group-pad — Manage create group pad

  • etherpad-pp-cli create-group-pad — creates a new pad in this group

create-pad — Manage create pad

  • etherpad-pp-cli create-pad — creates a new (non-group) pad. Note that if you need to create a group Pad, you should call createGroupPad

create-session — Manage create session

  • etherpad-pp-cli create-session — creates a new session. validUntil is an unix timestamp in seconds

delete-group — Manage delete group

  • etherpad-pp-cli delete-group — deletes a group

delete-pad — Manage delete pad

  • etherpad-pp-cli delete-pad — deletes a pad

delete-session — Manage delete session

  • etherpad-pp-cli delete-session — deletes a session

get-attribute-pool — Manage get attribute pool

  • etherpad-pp-cli get-attribute-pool — returns the attribute pool of a pad

get-author-name — Manage get author name

  • etherpad-pp-cli get-author-name — Returns the Author Name of the author

get-chat-head — Manage get chat head

  • etherpad-pp-cli get-chat-head — returns the chatHead (chat-message) of the pad

get-chat-history — Manage get chat history

  • etherpad-pp-cli get-chat-history — returns the chat history

get-html — Manage get html

  • etherpad-pp-cli get-html — returns the text of a pad formatted as HTML

get-last-edited — Manage get last edited

  • etherpad-pp-cli get-last-edited — returns the timestamp of the last revision of the pad

get-pad-id — Manage get pad id

  • etherpad-pp-cli get-pad-id — returns the read-write pad ID for a given read-only pad ID

get-public-status — Manage get public status

  • etherpad-pp-cli get-public-status — return true of false

get-read-only-id — Manage get read only id

  • etherpad-pp-cli get-read-only-id — returns the read only link of a pad

get-revision-changeset — Manage get revision changeset

  • etherpad-pp-cli get-revision-changeset — returns the changeset at a given revision of a pad

get-revisions-count — Manage get revisions count

  • etherpad-pp-cli get-revisions-count — returns the number of revisions of this pad

get-saved-revisions-count — Manage get saved revisions count

  • etherpad-pp-cli get-saved-revisions-count — returns the number of saved revisions of a pad

get-session-info — Manage get session info

  • etherpad-pp-cli get-session-info — returns information about a session

get-stats — Manage get stats

  • etherpad-pp-cli get-stats — returns server-wide statistics

get-text — Manage get text

  • etherpad-pp-cli get-text — returns the text of a pad

list-all-groups — Manage list all groups

  • etherpad-pp-cli list-all-groups — returns the IDs of all groups on this server

list-all-pads — Manage list all pads

  • etherpad-pp-cli list-all-pads — list all the pads

list-authors-of-pad — Manage list authors of pad

  • etherpad-pp-cli list-authors-of-pad — returns an array of authors who contributed to this pad

list-pads — Manage list pads

  • etherpad-pp-cli list-pads — returns all pads of this group

list-pads-of-author — Manage list pads of author

  • etherpad-pp-cli list-pads-of-author — returns an array of all pads this author contributed to

list-saved-revisions — Manage list saved revisions

  • etherpad-pp-cli list-saved-revisions — returns the list of saved revisions of a pad

list-sessions-of-author — Manage list sessions of author

  • etherpad-pp-cli list-sessions-of-author — returns all sessions of an author

list-sessions-of-group — Manage list sessions of group

  • etherpad-pp-cli list-sessions-of-group — returns all sessions of a group

move-pad — Manage move pad

  • etherpad-pp-cli move-pad — moves a pad — copy then delete the original

pad-users — Manage pad users

  • etherpad-pp-cli pad-users — returns the list of users that are currently editing this pad

pad-users-count — Manage pad users count

  • etherpad-pp-cli pad-users-count — returns the number of user that are currently editing this pad

restore-revision — Manage restore revision

  • etherpad-pp-cli restore-revision — restores a pad to a specific revision

save-revision — Manage save revision

  • etherpad-pp-cli save-revision — saves a revision of a pad

send-clients-message — Manage send clients message

  • etherpad-pp-cli send-clients-message — sends a custom message of type msg to the pad

set-html — Manage set html

  • etherpad-pp-cli set-html — sets the text of a pad with HTML

set-public-status — Manage set public status

  • etherpad-pp-cli set-public-status — sets a boolean for the public status of a pad

set-text — Manage set text

  • etherpad-pp-cli set-text — sets the text of a pad
Show full SKILL.md (582 more words)Show less
Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

bash
etherpad-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Auth Setup

Store your access token:

bash
etherpad-pp-cli auth set-token YOUR_TOKEN_HERE

Or set ETHERPAD_OPENID as an environment variable.

Run etherpad-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

  • Pipeable — JSON on stdout, errors on stderr

  • Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

    bash
    etherpad-pp-cli anonymize-author --agent --select id,name,status
  • Previewable — --dry-run shows the request without sending

  • Offline-friendly — sync/search commands can use the local SQLite store when available

  • Non-interactive — never prompts, every input is a flag

  • Explicit retries — use --idempotent only when an already-existing create should count as success

Response envelope

Commands that read from the local store or the API wrap output in a provenance envelope:

json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

Agent Feedback

When you (or the agent) notice something off about this CLI, record it:

etherpad-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
etherpad-pp-cli feedback --stdin < notes.txt
etherpad-pp-cli feedback list --json --limit 10

Entries are stored locally at ~/.etherpad-pp-cli/feedback.jsonl. They are never POSTed unless ETHERPAD_FEEDBACK_ENDPOINT is set AND either --send is passed or ETHERPAD_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

Output Delivery

Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

SinkEffect
stdoutDefault; write to stdout only
file:<path>Atomically write output to <path> (tmp + rename)
webhook:<url>POST the output body to the URL (application/json or application/x-ndjson when --compact)

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

Named Profiles

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

etherpad-pp-cli profile save briefing --json
etherpad-pp-cli --profile briefing anonymize-author
etherpad-pp-cli profile list --json
etherpad-pp-cli profile show briefing
etherpad-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.

Exit Codes

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
4Authentication required
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error

Argument Parsing

Parse $ARGUMENTS:

  1. Empty, help, or --help → show etherpad-pp-cli --help output
  2. Starts with install → ends with mcp → MCP installation; otherwise → see Prerequisites above
  3. Anything else → Direct Use (execute as CLI command with --agent)

MCP Server Installation

Install the MCP binary from this CLI's published public-library entry or pre-built release, then register it:

bash
claude mcp add etherpad-pp-mcp -- etherpad-pp-mcp

Verify: claude mcp list

Direct Use

  1. Check if installed: which etherpad-pp-cli If not found, offer to install (see Prerequisites at the top of this skill).
  2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
  3. Execute with the --agent flag:
    bash
    etherpad-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help: etherpad-pp-cli <command> --help.

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

Files

Just SKILL.md in cli-skills/pp-etherpad of mvanhorn/printing-press-library.

Open the folder on GitHubat commit 0fdcc7a

Compare with similar skills

Pp Etherpad 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.

Pp Etherpad compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pp Etherpad this skillmvanhorn/printing-press-library2.1k—~3.3kAutomated safety check: NotesApache-2.0
CSS Printthedaviddias/Front-End-Checklist74k—~422Automated safety check: PassMIT
Brand Kit Print Collateralsickn33/agentic-awesome-skills47k1 repos~6.4kAutomated safety check: PassMIT
PrintfulAnil-matcha/awesome-muse-connectors1.3k—~628Automated safety check: PassMIT
Press And PRappeeky/aso-skills2.2k—~1.8kAutomated safety check: PassMIT
Press Media Relationsaaron-he-zhu/aaron-marketing-skills2.9k—~3.1kAutomated safety check: PassApache-2.0

Similar skills

  • CSS Print

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing stylesheets, component styles, and responsive behavior related to Include a print stylesheet.

    74k GitHub stars~422 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Brand Kit Print Collateral

    sickn33/agentic-awesome-skills

    Print collateral spec: item, finished and trim size, bleed, colour mode, stock and GSM, finish, safe margin, print method, quantity and unit cost.

    47k GitHub starsUsed in 1 repo~6.4k tokens
    Marketing & SEOAuto-check passed
  • Printful

    Anil-matcha/awesome-muse-connectors

    Read Printful products and orders, create orders and mockups.

    1.3k GitHub stars~628 tokensUpdated 3 days ago
    Auto-check passed
  • Press And PR

    appeeky/aso-skills

    When the user wants to get press coverage, media mentions, or editorial features for their app — including writing press releases, pitching journalists, getting on "best apps" lists, or building an…

    2.2k GitHub stars~1.8k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Press Media Relations

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "build a media list for my launch", "write a launch press release", or "pitch press under embargo"; produces a three-tier media and analyst list (Tier 1…

    2.9k GitHub stars~3.1k tokensUpdated today
    Writing & ContentAuto-check passed
  • Standing rules for how any role in an OpenOPC company coordinates with its peers — work-item discipline, messaging, meetings, and blocking collaboration.

    1.8k GitHub stars~1.6k tokensUpdated 27 days ago
    Agent WorkflowsAuto-check passed

More from mvanhorn/printing-press-library

All 505 skills in this repo
  • Agent Desktop

    mvanhorn/printing-press-library

    Desktop automation through the real Rust agent-desktop CLI, published in Printing Press through a small bridge.

    2.1k GitHub stars~2.3k tokensUpdated yesterday
    Auto-check: notes
  • Gfonts

    mvanhorn/printing-press-library

    Search, browse, and download Google Fonts from the terminal via the gfonts CLI.

    2.1k GitHub stars~574 tokensUpdated yesterday
    Auto-check passed
  • Pp 1688

    mvanhorn/printing-press-library

    The free, offline Trigger phrases: search 1688 for, find a factory on 1688 for, wholesale price on 1688 for, who is the cheapest supplier on 1688 for, compare 1688 suppliers for, use 1688, run 1688.

    2.1k GitHub stars~3k tokensUpdated yesterday
    Auto-check: notes
  • Pp Activity Japan

    mvanhorn/printing-press-library

    Inspect known Activity Japan plan IDs or URLs, compare dated prices and sessions, check language-sitemap coverage, and hand off to canonical booking pages.

    2.1k GitHub stars~2k tokensUpdated yesterday
    Auto-check: notes
  • Pp Adminbyrequest

    mvanhorn/printing-press-library

    Every Admin By Request portal action, plus a local SQLite mirror of audit, events, inventory and requests for ad-hoc...

    2.1k GitHub stars~3.3k tokensUpdated yesterday
    Auto-check: notes
  • Pp Agent Capture

    mvanhorn/printing-press-library

    macOS screen capture, window recording, GIF conversion, and agent evidence bundles from the terminal.

    2.1k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check: notes

Questions about Pp Etherpad

What does Pp Etherpad do?

Printing Press CLI for Etherpad. An agent skill from mvanhorn/printing-press-library. Pp Etherpad is an agent skill from mvanhorn/printing-press-library. Printing Press CLI for Etherpad.

How do I install Pp Etherpad in Claude Code?

Run `npx skills add mvanhorn/printing-press-library --skill pp-etherpad -a claude-code`. Or copy the skill folder (cli-skills/pp-etherpad in mvanhorn/printing-press-library) into .claude/skills/pp-etherpad in your project. Claude Code loads it when a task matches its description.

How do I install Pp Etherpad in Codex?

Run `npx skills add mvanhorn/printing-press-library --skill pp-etherpad -a codex`. Or copy the skill folder (cli-skills/pp-etherpad in mvanhorn/printing-press-library) into .agents/skills/pp-etherpad in your project. Codex loads it when a task matches its description.

Can I use Pp Etherpad 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 mvanhorn/printing-press-library --skill pp-etherpad -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pp-etherpad, .gemini/skills/pp-etherpad, .github/skills/pp-etherpad and .opencode/skills/pp-etherpad in your project.

What does Pp Etherpad need to run?

Going by SKILL.md and its folder, Pp Etherpad needs the command-line tools its instructions call (claude, npx and go). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Read, Bash.

Does Pp Etherpad access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Pp Etherpad safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Pp Etherpad use?

Pp Etherpad is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pp Etherpad use?

About 3.3k tokens (SKILL.md is roughly 13k 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 Pp Etherpad?

Skills that share tags, products or a category with Pp Etherpad: CSS Print (thedaviddias/Front-End-Checklist, 74k stars), Brand Kit Print Collateral (sickn33/agentic-awesome-skills, 47k stars), Printful (Anil-matcha/awesome-muse-connectors, 1.3k stars) and Press And PR (appeeky/aso-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pp Etherpad?

mvanhorn (a GitHub user) maintains it in mvanhorn/printing-press-library, which has 2,053 GitHub stars. The repository holds 505 skills in this directory. The repository was last updated on October 7, 2026.

Source: mvanhorn/printing-press-library on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.