LaTeX compilation (latexmk)

Compile LaTeX source documents into PDF using latexmk with safe shell-escape isolation across CI events.

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.

latex-compilation

Compile LaTeX source documents into PDF using latexmk and pdflatex, with safe shell-escape isolation across trusted and untrusted environments.

Source: folio-assistant-sci/skills/content/folio-paper-adapter/latex-compilation.md.

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

Inputs and outputs

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

porttyperequireddescriptionconstraint
intexRepoPathyesThe TeX source file to compile (e.g. main.tex).string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.
inargsTextAdditional arguments to forward to latexmk.string · A short single-line human string. Not admissible as a command-line argument.
outpdfRepoPathThe compiled PDF document. Exits 2 if the source file is missing (could-not-determine).string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.

Processes and tasks

No process step names a skill this Tool satisfies.

How it is deployed and reached

  • Command line. From the repository root: bun run cat latex:compile. cat latex:compile runs cat-harness-tools/scripts/latexmk-compile.sh (declared in cat-harness-tools/package.json).
  • GitHub Actions. No workflow in this checkout runs its command.

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

installnone
runtimebash, latexmk, pdflatex
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/latexmk-compile.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/latexmk-compile.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": "latexmk-compile",
  "title": "LaTeX compilation (latexmk)",
  "description": "Compile LaTeX source documents into PDF using latexmk with safe shell-escape isolation across CI events.",
  "install": {
    "none": true
  },
  "invoke": {
    "shell": "bun run cat latex:compile"
  },
  "io": {
    "inputs": [
      {
        "name": "tex",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "The TeX source file to compile (e.g. main.tex).",
        "required": true,
        "arg": {
          "positional": 0
        }
      },
      {
        "name": "args",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/Text",
        "description": "Additional arguments to forward to latexmk.",
        "required": false
      }
    ],
    "outputs": [
      {
        "name": "pdf",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "The compiled PDF document. Exits 2 if the source file is missing (could-not-determine)."
      }
    ]
  },
  "satisfies": [
    "latex-compilation"
  ],
  "requirements": {
    "runtime": [
      "bash",
      "latexmk",
      "pdflatex"
    ],
    "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