Open a render

Open a rendered PDF, HTML page or image in the system browser, or list the renders available to open.

Skills it satisfies

A skill states the capability; this Tool is one way to exercise it. Each skill’s declared input and output contract follows, where it has one.

rendering-auditor

Multi-pass rendering auditor for content blocks. Validates markdown+TeX syntax, notation consistency, compilation, layout, and visual output across both HTML and PDF pipelines. Used by author agents after edits and as part of QC reports.

Source: folio-assistant-sci/skills/content/folio-paper-adapter/rendering-auditor.md.

The skill declares no I/O contract (schemas/skills/rendering-auditor/{input,output}.schema.json).

staging-review

Staging preview and before/after comparison for content review. Takes one optional string — what the reader wants to look at, in their own words — and returns a list of URLs, each looked up in the publish ref, with what is published at it and what to review there. Provides before (MAIN) and after (branches/) pairs so reviewers can compare rather than guess. Used by the CRDM feature development workflow, content authoring review sessions, and whenever a staging preview deploys or someone asks to see it.

Source: cat-harness/skills/ui/ui-core/staging-review.md.

Also satisfied by: folio-changeset.

input [1..1]output [1..1]pages [0..*]stagingLinks [1..1]staging-review«skill»staging-reviewinput : StagingReviewInput [1..1]output : StagingReviewOutput [1..1]StagingReviewInput«json-schema»StagingReviewInputask : string [0..1]branch : string [0..1]pr : integer [0..1]StagingReviewOutput«json-schema»StagingReviewOutputnarrative : string [1..1]startHere : string [0..1]stagingLinks : stagingLinks [1..1]stagingLinks.pages«json-schema»stagingLinks.pagestitle : string [1..1]before : string [0..1]after : string [0..1]summary : string [0..1]stagingLinks«json-schema»stagingLinksbranch : string [1..1]slug : string [1..1]branchUrl : string [1..1]pr : integer [0..1]mainBaseUrl : string [1..1]stagingBaseUrl : string [1..1]pages : stagingLinks.pages[] [0..*]missing : string[] [0..*]

input — cat-harness/schemas/skills/staging-review/input.schema.json, https://litlfred.github.io/folio-assistant/cat-harness/skills/staging-review/input.schema.json

fieldtyperequireddescription
askstringWhat the reader wants to look at, verbatim. Absent: the whole preview, every page the branch changed.
branchstring
printeger

output — cat-harness/schemas/skills/staging-review/output.schema.json, https://litlfred.github.io/folio-assistant/cat-harness/skills/staging-review/output.schema.json

fieldtyperequireddescription
narrativestringyesWhat a reader of the site will now see or do differently, and why, before any link.
startHerestringThe one page to open first.
stagingLinksstagingLinksyes

Inputs and outputs

Each port names a shared type by IRI, so two Tools for one skill can be checked for interchangeability.

porttyperequireddescriptionconstraint
infileRepoPathstring · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.
informatPreviewFormatstring · one of pdf, html, png · A previewable artefact: pdf, html or png.
inlistFlagboolean · A boolean switch — projects to a bare flag, with no value word
outopenedMarkdownWhat was opened, or the list of candidates.string · Markdown text. Not admissible as a command-line argument — see INJECTION_SAFE.

Processes and tasks

Steps this Tool can carry out, because each names a skill it satisfies:

processsteplanevia skill
Review taskClassify what changedReviewer / SMEstaging-review
CRDM Phase 6 — implement, MVP, acceptancePost summary to issueAgentstaging-review
CRDM Phase 6 — implement, MVP, acceptanceShare MVP with stakeholdersBA / Feature Requestorstaging-review
Code change and reviewCommit, push, open the PRAuthoring agentstaging-review
Code change and reviewReview the changeCode reviewerstaging-review
Staging a feature branch preview, and taking it downComment the preview URL on the PRCI/CD Pipelinestaging-review
Staging a feature branch preview, and taking it downPost the retention notice on the PRCI/CD Pipelinestaging-review
Adopting an upstream version bumpReview the MVP against what we bind toReviewer / SMEstaging-review
Questionnaire wireframe reviewAsk for review with deep linksFHIR modellerstaging-review
Committee review of a content changeCompare main vs stagingReview Committeestaging-review
Committee review of a content changeSlice the change and assign reviewersReview Coordinatorstaging-review
Content Change and ReviewReview staged renderingContent Authorstaging-review
Content Change and ReviewRequest further revisionsContent Authorstaging-review
Content Change and ReviewSubmit to review committeeContent Authorstaging-review
Draft, review and publishCirculate the draftPublication managerstaging-review
Draft, review and publishReview the draft publicationReview team (content · QC · technical officer)staging-review
Draft, review and publishClinical or scientific sign-offClinical / scientific SMEsstaging-review
Make a decided public comment changeReview the change set on its staging previewChange set — feature branch and stagingstaging-review
Review and publish a folioReview and record feedbackReviewerstaging-review
SMART Guideline end to endReview each L2 asset (before / after if adapted)Human adjudicatorsstaging-review
SMART Guideline end to endReview each L3 asset (before / after if adapted)Human adjudicatorsstaging-review
SMART Guideline end to endAdjudicate the L4 wireframes and applicationHuman adjudicatorsstaging-review
Classify and code contentStage codings, warnings and exclusions for reviewAuthoring agentstaging-review
L2 component edit and reviewAsk for review with staging deep linksAuthoring agentstaging-review

How it is deployed and reached

  • MCP. Served as paper_preview by sage (cat-harness-tools/scripts/sage-mcp.sh), google-drive (cat-harness-tools/scripts/google-drive-mcp.sh), folio-assistant (bun run cat-harness-tools/src/index.ts --stdio --repo .), the servers .mcp.json declares.
  • In process. adapters/paper/tools/preview.ts — loaded by the harness directly, with no server.
  • GitHub Actions. No workflow in this checkout runs its command.

The MCP tool it serves, as tools/list answers:

paper_preview — read from its registrar.

paper_preview [1..1]paper-preview«tool»paper-previewpaper_preview : PaperPreviewInput [1..1]PaperPreviewInput«json-schema»PaperPreviewInputfile : string [0..1]format : "pdf" | "html" | "png" [0..1]list : boolean [0..1]
parametertyperequireddescription
filestringSpecific file to open (path relative to build/ or absolute)
formatpdf \| html \| pngFilter by format when listing available renders
listbooleanJust list available renders without opening

As an API: its operation in the OpenAPI document and the MCP tool list of its layer.

installnone
networkno

What it is made of

Linked data

The Tool is published as its own JSON-LD document at its IRI, https://litlfred.github.io/folio-assistant/folio-assistant-sci/tools/paper-preview.jsonld, partOf its layer’s document. The node below is the definition this page was drawn from, and is embedded in the page as application/ld+json.

{
  "@context": "https://litlfred.github.io/folio-assistant/folio-assistant-sci/folio-assistant-sci.context.jsonld",
  "@id": "https://litlfred.github.io/folio-assistant/folio-assistant-sci/tools/paper-preview.jsonld",
  "@type": "https://litlfred.github.io/cat-harness/v0/ns/Tool",
  "partOf": "https://litlfred.github.io/folio-assistant/folio-assistant-sci/folio-assistant-sci.jsonld",
  "name": "paper-preview",
  "title": "Open a render",
  "description": "Open a rendered PDF, HTML page or image in the system browser, or list the renders available to open.",
  "install": {
    "none": true
  },
  "invoke": {
    "mcp": {
      "tool": "paper_preview"
    },
    "inProcess": {
      "module": "adapters/paper/tools/preview.ts"
    }
  },
  "io": {
    "inputs": [
      {
        "name": "file",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "required": false,
        "arg": {
          "positional": 0
        }
      },
      {
        "name": "format",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/PreviewFormat",
        "required": false,
        "arg": {
          "flag": "--format"
        }
      },
      {
        "name": "list",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/Flag",
        "required": false,
        "arg": {
          "flag": "--list"
        }
      }
    ],
    "outputs": [
      {
        "name": "opened",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/Markdown",
        "description": "What was opened, or the list of candidates."
      }
    ]
  },
  "satisfies": [
    "rendering-auditor",
    "staging-review"
  ],
  "requirements": {
    "network": false
  }
}

folio-assistant — code under the Apache License 2.0, documentation under CC BY 3.0. Generated schema and API references are rebuilt from source on every push to main.

deployed dev