Files
claude-engineering-plugin/plugins/compound-engineering/skills/proof-push/SKILL.md
John Lamb a7b15298e0
Some checks failed
CI / pr-title (push) Has been cancelled
CI / test (push) Has been cancelled
Release PR / release-pr (push) Has been cancelled
Release PR / publish-cli (push) Has been cancelled
Merge step (b): carry in local-only files at original paths
Brings 47 local-only files from backup-local-main into the merge-upstream
branch at their pre-rename paths. Subsequent steps will rename these to
the ce-* convention and port shared-file merges.

Includes:
- Custom skills: john-voice, jira-ticket-writer, hugo-blog-publisher,
  weekly-shipped, proof-push, ship-it, story-lens, sync-confluence,
  excalidraw-png-export, python-package-writer, fastapi-style,
  upstream-merge
- Custom agents: design-conformance-reviewer, tiangolo-fastapi-reviewer,
  zip-agent-validator, python-package-readme-writer, lint
- Custom commands: essay-edit, essay-outline, pr-comments-to-todos,
  resolve_todo_parallel, workflows/{plan,review,work}
- Local mods to ce-review/SKILL.md + review-output-template.md (will be
  ported to ce-code-review in a later step)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-24 12:40:27 -05:00

1.5 KiB

name, description
name description
proof-push This skill should be used when the user wants to push a markdown document to a running Proof server instance. It accepts a file path as an argument, posts the markdown content to the Proof API, and returns the document slug and URL. Triggers on "push to proof", "proof push", "open in proof", "send to proof", or any request to render markdown in Proof.

Proof Push

Push a local markdown file to a running Proof server and open it in the browser.

Usage

Accept a markdown file path as the argument. If no path is provided, ask for one.

Execution

Run the bundled script to post the document:

bash scripts/proof_push.sh <file-path> [server-url]
  • file-path — absolute or relative path to a .md file (required)
  • server-url — Proof server URL, defaults to http://localhost:4000

The script:

  1. Reads the file content
  2. POSTs to /share/markdown as JSON with {markdown, title}
  3. Returns the slug, base URL, and editor URL with access token

Output

Report the returned slug and URLs to the user. The editor URL (with token) gives full edit access.

Error Handling

If the script fails, check:

  • Is the Proof server running? (curl http://localhost:4000)
  • Does the file exist and contain non-empty markdown?
  • Is jq installed? (required for JSON construction)

Resources

scripts/

  • proof_push.sh — Shell script that posts markdown to Proof's /share/markdown endpoint and returns the document slug and URLs.