ce-proof

Coordinate human-in-the-loop review of local Markdown documents via Proof.

Updated Sep 25, 2024
One-click install
npx skills add https://github.com/kwam1na/athena --skill ce-proof-kwam1na
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ce-proof
Source: https://github.com/kwam1na/athena/tree/main/.agents/skills/ce-proof
Command: npx skills add https://github.com/kwam1na/athena --skill ce-proof-kwam1na

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill enables humans and agents to perform human-in-the-loop review of local Markdown documents by uploading them to Proof, collecting threaded feedback and tracked edits, and syncing the final, reviewed version back to the local file.

Core Features & Use Cases

  • HITL review workflow: upload a local Markdown file to Proof, annotate feedback in Proof's UI, and ingest replies and edits back into the document.
  • Two-way sync: automatically push approved changes back to the local file or choose to defer syncing until the user approves.
  • Presence and collaboration: establish agent identity, share a Proof doc URL, and manage unresolved threads across upstream handoffs (ce-brainstorm/ce-ideate/ce-plan).

Quick Start

Upload your local Markdown file to Proof and start a HITL review, then follow the terminal prompts to sync changes back to your file.

Frequently Asked Questions about ce-proof

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

FAQPage Schema
How do I set up human-in-the-loop review for local Markdown files?

To enable human-in-the-loop document review, this skill uploads local Markdown files to Proof, captures threaded comments and tracked edits, and syncs the final reviewed version back to your local disk.

What is the best way to collect threaded comments and inline edits on offline Markdown drafts?

The best way to collect inline edits on offline Markdown drafts is by uploading them to Proof, allowing collaborators to annotate feedback directly in the UI, and syncing the tracked changes back to your local file.

Can I automatically sync reviewed Markdown documents back to my local disk?

Yes, you can automatically push approved changes from Proof back to your local Markdown file, or choose to defer syncing until you manually approve the reviewed edits.

Does the Proof review workflow integrate with upstream Markdown ideation and planning stages?

Yes, the Proof review workflow integrates with upstream ideation and planning stages by establishing agent presence, sharing a document URL, and managing unresolved threads across upstream handoffs.

When should I use a dedicated collaboration platform instead of local Markdown document review?

You should use a collaboration platform like Proof for local Markdown review when your team drafts offline but requires structured HITL review, inline edits, and a final automated sync back to disk.