content-share-protocol

Publishes HTML artifacts to soli-frames via GitHub repository_dispatch with a five-phase gated protocol.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/soli92/soli-projects --skill content-share-protocol-soli92
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: content-share-protocol
Source: https://github.com/soli92/soli-projects/tree/main/.cursor/skills/content-share-protocol
Command: npx skills add https://github.com/soli92/soli-projects --skill content-share-protocol-soli92

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Publishing HTML artifacts (reports, guides, agent outputs) to the soli-frames viewer requires a strict, safe dispatch process: misconfigured payloads cause GitHub API 422 errors, oversized files get rejected, and outward-facing actions need human approval. This Skill enforces a five-phase protocol that validates configuration, classifies egress risk, and gates every dispatch behind explicit human confirmation. ## Core Features & Use Cases - Five-phase dispatch pipeline: Pre-flight + Egress Check, Build Payload, Validate, Human Gate, and Dispatch + Log, each with explicit STOP conditions. - Egress classification (R.CS4): Blocks analytics reports containing sensitive per-actor or rate-card data before any external call. - Strict payload contract: Builds the nested event_type/client_payload JSON with base64-encoded HTML, slug regex validation, and size limits (100 KB hard cap). - Mandatory human gate (R.CS3): Shows a dispatch summary and requires explicit confirmation; supports --dry-run for payload inspection without sending. - Use Case: After generating a sprint report HTML, run the protocol to validate the slug, check the 80 KB warning threshold, review the summary, and dispatch it to soli-frames as a draft pending merge. ## Quick Start Ask the agent to share the generated HTML report to soli-frames using the content share protocol with the dry-run flag first to inspect the payload.

Frequently Asked Questions about content-share-protocol

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

FAQPage Schema
How do I publish an HTML report to soli-frames from my repository?▼

Enable content_share in factory.config.yaml with source_repo_slug and source_repo, configure SOLI_FRAMES_PAT and SOLI_FRAMES_DISPATCH_SECRET, then run the protocol. It validates the payload, shows a summary, and dispatches via GitHub repository_dispatch after your confirmation.

How to fix GitHub API 422 error on repository_dispatch?▼

A 422 usually means the payload is flat instead of nested. The dispatch body must wrap fields in an event_type of content-ingest plus a client_payload object containing dispatch_secret, slug, title, html_b64, publish, and source_repo.

What are the size limits for HTML content dispatch to GitHub?▼

HTML decoded content has a hard limit of 100 KB and a warning threshold at 80 KB. The total JSON payload must stay under 10 MB, which is the GitHub API limit for repository_dispatch events.

Can I dispatch content without human confirmation?▼

No. The human gate in Phase 3 is mandatory because dispatch is an outward, non-reversible action. You can use --dry-run to inspect the full payload and summary without sending anything.

Why is my analytics report blocked from being shared?▼

The egress classification check blocks analytics_report artifacts containing per-actor data, rate cards, or GDPR-sensitive information. Sanitize the report first or run with --dry-run to inspect what would be sent.