skills.rest
Jerrylalala
JerrylalalaCOMMUNITY
Explore all skills by this author →
GitHub

proof

Create, edit, and comment on shared markdown documents via the Proof web API and local bridge.

6|2|Updated Jan 30, 2026
Search Tags:#markdown#collaboration#api#comments#document review#proof#suggestions
One-click install
npx skills add https://github.com/Jerrylalala/compound-engineering --skill proof-jerrylalala
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: proof
Source: https://github.com/Jerrylalala/compound-engineering/tree/main/plugins/compound-engineering/skills/proof
Command: npx skills add https://github.com/Jerrylalala/compound-engineering --skill proof-jerrylalala

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Collaborating on markdown documents with humans requires a shared editing surface; this Skill lets an agent create shareable documents, read their state, add comments, and suggest edits through Proof's web API or the local macOS bridge without manual copy-pasting. ## Core Features & Use Cases - Shared Document Creation: Create markdown documents via the Proof web API and receive a shareable token URL with no authentication setup. - Comments and Suggestions: Add comments, replies, and replace/delete suggestions on shared documents through the ops endpoint, with attribution via the by field. - Local Bridge Integration: Drive the macOS Proof app over localhost:9847 to read state, manage marks, and publish presence statuses. - Use Case: Given a proofeditor.ai URL, read the document state, then post review comments and replacement suggestions that the author sees in real time. ## Quick Start Use the proof skill to create a shared markdown document titled "Release Notes" and give me the shareable link.

Frequently Asked Questions about proof

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a shareable markdown document with Proof?▼

POST JSON with a title and markdown body to https://www.proofeditor.ai/share/markdown. The response returns a slug, a shareable tokenUrl, and API links for reading state and posting operations, with no authentication required to create.

How do I comment on or suggest edits to a Proof document?▼

Send operations to POST /api/agent/{slug}/ops with an x-share-token header. Use comment.add for comments, suggestion.add with kind replace or delete for edits, and rewrite.apply for full-document changes, always including a by field for attribution.

Does Proof work without the macOS app installed?▼

Yes, the web API at proofeditor.ai works without any installation for creating, reading, and editing shared documents. The local bridge at localhost:9847 is only needed to drive the macOS Proof app directly.

Why does suggestion.add with kind insert fail on the web API?▼

The web ops endpoint returns Bad Request for insert suggestions. Use kind replace with a broader quote, or use rewrite.apply to apply insertions as part of a full-document rewrite instead.

Why do Proof bridge endpoints return 426 CLIENT_UPGRADE_REQUIRED?▼

Bridge-style /d/{slug}/bridge/* endpoints require client version headers such as x-proof-client-version and x-proof-client-protocol. Use the /api/agent/{slug}/ops endpoint instead, which does not require those headers.

Related Skills

Explore More Content & Communication Skills→
mmnavarrmmnavarr

ce-proof

Run human-in-the-loop markdown review loops via the Proof collaborative editor API.

Community
Advanced
MoonLadderStudiosMoonLadderStudios
12

fix-comments

Resolve GitHub pull request review comments and push validated fixes.

Official
Advanced
qlawmarqqlawmarq

writing-review

Review blog content for SEO, grammar, accuracy, and reliability.

Community
Advanced
KnoWhizKnoWhiz
6

google-docs

Read, comment on, and edit Google Docs with revision marks.

Official
Advanced