publish-mirrorlisted

Mirror repo-first documentation (Markdown or a finished HTML page) out to one or more published targets — a wiki such as Confluence, an educational portal — keeping the same visual language, accessibility, and built-versus-designed honesty. A separate publish step that runs AFTER an authoring skill has written and verified the source in the repository; it never authors content itself. Use this whenever the user wants to publish, mirror, sync, or push existing docs to Confluence, a wiki, or a learning portal, to set up repo-to-wiki publishing, or to add a publish destination. It reads a publish-targets manifest for every coordinate, renders through an adapter, records each change before editing a published page, gates every write behind human approval, and runs a publish-reviewer. NOT for writing the docs themselves (use learning-track, architecture-and-decisions, project-faq, usage-guide, operations-runbook, or onboarding-companion).
imrohitagrawal/project-doc-skills · ★ 0 · AI & Automation · score 58

Install: claude install-skill imrohitagrawal/project-doc-skills

# Publish & Mirror Version: 1.2.0 · see `CHANGELOG.md`. Take Markdown that an authoring skill has already written and verified in the repository, and mirror it out to one or more published targets — a wiki, an educational portal — so each target carries the **same visual language, the same accessibility, and the same built-versus-designed honesty** as the source. This skill **does not write documentation.** It is the publish step the authoring skills hand off to. Read these two files first, every time: - `references/render-contract.md` — the source primitives, the per-target adapters, and the graceful-degradation rule. This is *how* a page is rendered for a target. - `assets/publish-targets.yaml` — the manifest (copy it into the repo as `docs/publish-targets.yaml` and fill it). This is *where* a page goes and *which* target it goes to. **The one idea that makes this safe and scalable:** the authoring skills emit a small, fixed set of renderable primitives (collapsible blocks, bold-label callouts, a table-of-contents line, diagrams exported to images, honesty markers, a licence footer). This skill renders *those* and nothing else, through a per-target adapter, using coordinates that live *only* in the manifest. So adding a target never means changing how anything is written. --- ## Before you start: what this needs, when to run it, where it fits ### What this skill needs (the inputs) - **Verified Markdown in the repo.** The authoring skill has run its loop and its