claude

PUBLISH — Publishing & Documentation

Turns project artefacts and markdown into publication-grade output: narrative articles mined from git history and docs, standalone diagrams (Graphviz + a Mermaid-native specialist covering the full diagram taxonomy, theming, and ELK), and print-quality PDFs with embedded, A4-legible figures — all held to standard by an adversarial design-reviewer (typography + data-viz canon) that critiques the rendered artefact in a convergent loop. The PUBLISHING companion deliver hands off to when richer-than-markdown output is wanted — or use it directly on any project.

0 on GitHubby whatbirdisthatv1.4.0MIT OR Apache-2.0updated 2 months agodocumentation
/

Plugin publish from marketplace idea-to-production in agentic-underground/idea-to-production. Commands read from the repo's manifest — 1 month ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.

What it installs

Skills (10)

  • check

    Verify PUBLISH's typesetting/rendering tools are installed and reachable — typesetters (typst, pdflatex), diagram renderers (dot, mmdc), and DTP/conversion tools (pdfinfo, gs, pandoc, libreoffice). Trigger with /publish:check (or "check publish prerequisites", "can I render a PDF?"). Reports which P

  • craft-study

    Empirically discover which MULTI-STAGE ComfyUI techniques raise image craft. Loop-driven experiment (no command, run under /loop): a controlled single-variable A/B — baseline vs one named stage (e.g. latent hires-fix, a dark-key LoRA) — scored from a contact sheet, folding the proven gains into the

  • design-reviewer

    Adversarially review the VISUAL design of a rendered document or chart — PUBLISH's print/DTP and data-viz quality gate. Trigger with /publish:design-review (or "review this PDF's typography", "critique this chart"). Guard: PUBLISH only. Rasterises PDF pages (or a chart image) for Claude vision, scor

  • diagram-studio

    Author standalone, legible diagrams (Graphviz DOT, Mermaid) rendered to SVG/PNG/PDF for embedding in any target — docs, READMEs, web, slides, or print. Trigger by "a diagram", "an architecture diagram", "a flowchart", "render this as a graph". Guard: PUBLISH only. Carries the charting-matrix legibil

  • document-review

    Adversarially review the PROSE of any document — PUBLISH's copy/editorial gate, prose peer to design-reviewer. Trigger with /publish:document-review (or "copy-review this README", "critique the prose of this spec"). Guard: PUBLISH only. Judges clarity, accuracy, tone, punchiness, cohesion; returns q

  • illustrator

    Trawl documentation, find the highest-impact spots a figure would clarify, and drive each from SPEC to two options to an adversarial A/B design review to an embedded dark-mode asset. Orchestrator of PUBLISH's graphical handlers (Graphviz, Mermaid, chart, composition, ComfyUI). Trigger with /illustra

  • model-survey

    Explore, test, score, and journal the image models on the ComfyUI backend so PUBLISH picks models on evidence. Loop-driven experiment (no command, run under /loop): generates a curated checkpoint subset (SDXL + SD1.5) across test objectives, the design team scores each, and folds findings into the m

  • rich-pdf-with-diagrams

    Produce a print-quality PDF article with embedded Graphviz/TikZ diagrams that respect A4-portrait composition. Downstream of WRITER — product-noun triggers "rich PDF", "print edition", "publication-ready PDF", "PDF with diagrams". Guard: PUBLISH only. Typesets a typographically sound, visually balan

  • self-improve

    Improve PUBLISH itself — fold design feedback into its charting-matrix, templates, and reviewer rubrics, or self-cleave an over-broad element. Trigger with /publish:self-improve (or "this chart passed review but read poorly — fix the matrix", "the PDF engine fell over — harden it"). Applies on a bra

  • writer

    Write an article, narrative, technical post, origin story, retrospective, or release notes derived from a project's source (git history, doc/, README, code). Trigger by "write an article", "write an origin story", "write a retrospective", "tell the story of this codebase". Guard: PUBLISH only. Runs

Slash commands (5)

  • /publish:check

    Verify PUBLISH's typesetting/rendering tools (typst/pdflatex, dot, mmdc, pandoc, gs) are installed — a ✓/✗ table by tier that reports which PDF engine(s) are available (advisory; --strict to fail on a missing required tool).

  • /publish:document-review

    Adversarially review the PROSE of any document (copy-review) — clarity, accuracy, tone, punchiness, tangents — and return prioritised, evidence-citing findings plus one verdict. The prose peer to design-review (it owns the WORDS; design-review owns the PAGE). Invocable on a spec, README, gap map, or

  • /publish:illustrate

    Illustrate documentation — find the highest-impact figure-sites and drive each from SPEC → two options → an A/B-until-best design review → an embedded dark-mode, transparent-background asset. One file, one section, the current doc, or a /loop-driven trawl of the whole doc tree (embedding + ledgering

  • /publish:inspect

    Inspect the PUBLISH plugin itself — audit skills, agents, and knowledge for drift, gaps, and duplication; produce a severity-ranked report.

  • /publish:publish

    Publish project material as an article, diagrams, or a print-quality PDF — the single front door to PUBLISH (writer + diagram-studio + rich-pdf).

Subagents (8)

  • handler-chart

    PUBLISH GRAPHICAL VALUE_HANDLER for quantitative charts. Consumes an ILLUSTRATOR SPEC (with data) and emits one dark-mode, transparent-background SVG chart — bar, line, dot, area-where-honest, small-multiple — obeying the data-viz canon (Cleveland–McGill encoding, Tufte data-ink, honest baselines, c

  • handler-comfyui

    PUBLISH GRAPHICAL VALUE_HANDLER for generative raster figures. Consumes an ILLUSTRATOR SPEC and emits one PNG via a live ComfyUI server — for genuinely pictorial figures (hero art, texture, photoreal concept) where vector handlers cannot express the idea. Picks a MULTI-STAGE pipeline (base · LoRA st

  • handler-composite

    PUBLISH GRAPHICAL VALUE_HANDLER for SVG↔raster blends and animated figures — the marketing-masthead (raster atmosphere under crisp vector type/frame/data) and motion figures (a diagram that builds up, a hero that breathes). Consumes an ILLUSTRATOR SPEC with output_format gif|apng|mp4|png|svg (incl.

  • handler-composition

    PUBLISH GRAPHICAL VALUE_HANDLER for hand-authored SVG compositions — concept posters, labelled illustrations, annotated callouts, hero figures, and conceptual diagrams that carry no graph semantics (so Graphviz/Mermaid are the wrong tool). Consumes an ILLUSTRATOR SPEC and emits one dark-mode, transp

  • handler-docx

    PUBLISH VALUE_HANDLER for .docx document production. Expert in pandoc 3.10 reference-doc templating, python-docx + lxml/oxml fine control, OOXML structural validation, and the accessibility triad (heading outline + image alt text + semantic table headers). Spawned by TEST-AGENT, IMPLEMENT-AGENT, and

  • handler-graphviz

    PUBLISH GRAPHICAL VALUE_HANDLER for structural diagrams. Consumes an ILLUSTRATOR SPEC and emits one dark-mode, transparent-background SVG via Graphviz DOT, composed to the 4×9 charting matrix. Spawned by the illustrator skill during option generation (A or B) when the figure is a structured graph —

  • handler-mermaid

    PUBLISH GRAPHICAL VALUE_HANDLER for Mermaid-native figures. Consumes an ILLUSTRATOR SPEC and emits one dark-mode, transparent-background SVG via Mermaid (mmdc), themed from the dark-mode canon. Spawned by the illustrator skill during option generation (A or B) when the figure is what Mermaid express

  • inspector

    PUBLISH INSPECTOR — on-demand agent that audits the PUBLISH plugin it ships in (skills, agents, knowledge, commands under ${CLAUDE_PLUGIN_ROOT}). Triggered by user command only ("inspect PUBLISH" / "/publish:inspect"). Builds a fresh critical-analysis persona, reads every file, and produces PUBLISH_

Hooks (1)

  • SessionStart

    bash ${CLAUDE_PLUGIN_ROOT}/hooks/inject-kaizen.sh 2>/dev/null || true

View source on GitHub

More from agentic-underground/idea-to-production

All 8 plugins →

An opinionated, disciplined, quality-first software production system. A conveyor that carries value from IDEA to PRODUCTION across role-tuned agents and value-stations (IDEA ▶ ROADMAP ▶ PLAN ▶ EARS ▶ FEATURE ▶ TEST ▶ IMPLEMENT ▶ STORY ▶ SHIP), governed by three pillars — knowledge parity, quality-first with a performance-delta gate, and waste elimination (muda·mura·muri) — under an overarching token-efficiency constraint. Emits markdown; uses the secure and publish companions automatically when present.

19 skills · 13 commands · 32 agents · 1 MCP server · hooks

0

The FRONT DOOR, ARRIVAL layer, and meta-layer of the marketplace — the marketplace-level surface the specialist plugins never had. /i2p:help browses the powers you have now, grouped by the DISCOVER ▸ IDEATE ▸ BUILD ▸ DESIGN ▸ SECURE ▸ PUBLISH value flow (listing only what is installed); /i2p:review fans out EVERY installed reviewer — code (deliver), design (design), rendered docs (publish), security (secure) — into ONE adversarial verdict in I2P_REVIEW.md; /i2p:check consolidates every plugin's readiness into one table; /i2p:flow maps where each plugin sits and the next command to run; /i2p:focus declares the active lifecycle phase for context routing so out-of-phase skills stay dormant ('focus, don't uninstall'), broadcast by a SessionStart hook so it survives /clear. It also GREETS whoever opens a repo: a SessionStart hook renders a maintainer-authored .claude/welcome.md (/i2p:define-welcome authors it), and /i2p:statusline turns on the rich two-line idea-to-production status line (context & rate-limit gauges, the product-lifecycle phase, a ⚔ reviewer-catch tally), offered once on first activation. Introduces itself on session start and surfaces occasional ≤25-word tips. A thin orchestrator that delegates to the specialists by capability and never re-implements them. Carries the KAIZEN self-improvement covenant.

10 skills · 10 commands · 1 agent · hooks

0

The OPERATE phase owner — what runs a mission AFTER launch. OPERATE keeps the live product alive and improving: it verifies operational readiness at go-live, instruments and watches the four golden signals (observability), runs incident response (severity, incident-command roles, mitigate-first, runbooks, blameless postmortems), keeps a maintenance cadence (dependency upkeep + CVE patching + tech-debt), and closes the build-measure-learn loop by turning production signals into a new opportunity that re-enters DISCOVER (the cyclic re-entry). /operate-gate is the front door — an operational-readiness check at go-live and the steady-state health view with a READY / WATCH / NOT-READY verdict. Grounded in named canon (SRE SLIs/SLOs/error budgets + golden signals, the Incident Command System, build-measure-learn, ITIL-lite). Stands alone on any live project, or advances the idea-to-production lifecycle OPERATE → DISCOVER (↻) when i2p is installed. Composes the secure plugin's scan-dependencies and hands new opportunities to discover/ideate by capability. Carries the KAIZEN self-improvement covenant: every incident becomes a runbook, every alert gap becomes an SLO.

9 skills · 9 commands · 1 agent · hooks

0

The pre-release security gate for any repository. Catches PII, secrets/credentials, and supply-chain risk before they ship. Runs parallel, multi-agent audits across data files, git history, source, and frontend, and consolidates them into a single severity-ranked report with a PASS / REVIEW / BLOCK verdict. Stands alone, or serves as deliver's SECURE gate when both are installed.

6 skills · 6 commands · 1 agent · hooks

0

The DISCOVERY front door of the marketplace — upstream of any code. Set a standing discovery /discovery-goal, then run /market-scan: an adversarially-challenged dialogue over a market parameter taxonomy (problem severity, demand evidence, market size, willingness-to-pay, pricing power, competition, reachability, stack-fit) that proposes, scores, validates, and NARROWS candidate opportunities, killing weak ideas early. Loop it over your goal until one candidate earns a keep verdict — the spark. Hands a validated OPPORTUNITY to the ideate plugin when installed, or emits a structured markdown opportunity brief standalone. Self-improving: downstream feedback sharpens the parameters and scoring over time.

4 skills · 4 commands · 2 agents · 1 MCP server · hooks

0

The REFINEMENT phase of the marketplace. Takes a validated opportunity (from discover) or a raw idea you already have and refines it to knowledge-parity through an adversarially-challenged dialogue, producing the IDEA PACKAGE: precise AGENT-FACING handoff documents (idea brief, subject-matter-understanding seed, first vertical slice, and a handoff contract that satisfies DELIVER's discovery exit criteria) plus rich, illustrated USER-FACING documents (opportunity narrative, parameter scorecard, market/pricing/competition charts, a user-flow, and a mockup screen) rendered by capability — charts via publish, user-flows/mockups via design (design-reviewed) — when installed; degrades to markdown otherwise. Iterated with the user before hand-off, then carried to PRODUCTION by DELIVER. Supersedes DELIVER's inline ideate, which remains as a graceful-degradation fallback. Also runs /ideate:name — a marketing-grade naming studio: a deep discovery interview (audience, brand archetype, name-type appetite, power-adjacency, humour, risk), wide-net generation across the full name-type taxonomy + affix hooks + phonosemantic tuning, a deterministic token-free checker (registries + neighbour/typo-squat proximity + domain/RDAP + cross-language connotation), and a scored challenge (Neumeier 7 / SMILE-SCRATCH / archetype-fit). Self-improving: ambiguities a downstream builder hits flow back to sharpen the question-bank and the package contract.

4 skills · 4 commands · 2 agents · 1 MCP server · hooks

0

Similar plugins

humanizer

claude

Rewrite AI-sounding text so it reads like the writer without changing what it says.

1 skill

blader/humanizer 68,461

context7

claudecodex

Up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your coding agent's context.

1 MCP server

upstash/context7 64,709

5 skills + 35 modes + Material Passport pipeline. Includes v3.6.7 cross-model audit gate and v3.6.8 generator-evaluator contract.

5 skills · 16 commands · 4 agents · hooks

Imbad0202/academic-research-skills 56,698

OpenAPI specification generation, Mermaid diagram creation, tutorial writing, API reference documentation

3 skills · 1 command · 5 agents

wshobson/agents 42,461

qmd

claude

Search and retrieve documents from local markdown files.

2 skills

tobi/qmd 31,085

promptfoo

claudecodex

Connect providers and targets, write eval suites, and set up or run red team scans with promptfoo

4 skills

promptfoo/promptfoo 27,115

Maintain PUBLISH — Publishing & Documentation?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins8 plugins