Skip to main content

Workflows

Every capability is a reusable workflow you call with a small stub. The table below is the full catalog; each workflow links to its reference page, with full input tables and a copy-paste example.

Workflow Purpose Key inputs
ai-code-review.yml Multi-agent PR review. agents, pr-number, claude-review-workflow-file, gemini-review-workflow-file, antigravity-review-workflow-file, cursor-review-workflow-file, opencode-review-workflow-file, watch-timeout
altdoc-multiversion-docs.yml Render an altdoc-based R package’s Quarto docs site and deploy multiple versions side by side on gh-pages: PRs to /pr-preview/pr-<number>/, pushes to the default branch to /dev/, published releases to /latest-tag/ and /vX.Y.Z/, and a root / redirect landing page into the default docs version. r-packages, needs, apt-packages, setup-julia, checkout-submodules, default-branch, quarto-config-path, docs-base-url, preview-branch, legacy-paths, root-landing-target, version-dropdown-title-template, version-in-navbar-title, timeout-minutes, rewrite-pr-preview-links, rewrite-issue-links, dispatch-version, dispatch-release-tag
annotation-gate.yml Fail a run that carries an annotation nobody allowed. levels, allow-patterns, job-name
annotation-gate-run.yml Annotation gate for a finished run (reusable) run-id, run-attempt, head-sha, workflow-id, all-runs, defer-while-running, backfill, repair-workflows, repair-hours, levels, allow-patterns
antigravity-code-review.yml Automated agentic code review, security audit, or test-suite generation via the Google Antigravity Python SDK (google-antigravity). mode, pr-number, prompt-addendum, checkout-submodules, model, trigger-policy, workload-identity-provider, service-account, gcp-project, gcp-location, max-diff-lines, max-diff-files, fail-on-error
bump-dev-version.yml Bump an R package’s DESCRIPTION dev-version counter (the 4th .90NN component, e.g. 0.1.0.9057 -> 0.1.0.9058) after every merge to main, and open – or auto-merge – a PR to carry it in. description-path, base-branch, pr-branch, auto-merge, dry-run, pr-labels
bump-submodule.yml Update a named submodule to its upstream HEAD and open a PR when the pointer moves. submodule-path, remote-branch, base-branch, pr-branch
cancel-superseded.yml Cancels the queued and running workflow runs of a pull request that were started for a head the pull request no longer has, and, once the pull request closes, the runs started before it closed.
check-ai-tells.yml Scans narrative prose in Markdown and Quarto files (*.md, *.qmd, *.Rmd) for AI tell patterns (e.g. overused vocabulary, negation-reversal antithesis, signposting filler), computing tell density per 1,000 words. paths, paths-ignore, base-ref, threshold, ignore-tells, fail
check-avoided-words.yml Diff-scoped check that flags words and phrases a style source advises against, in .qmd and .md prose. whole-tree, globs, paths-ignore, fail
check-axis-titles.yml Diff-scoped, blocking check that flags an axis title made only of a symbol or an expression. whole-tree, globs, paths-ignore, fail
check-bare-yes-no.yml Diff-scoped check that fails when a pull request adds a solution paragraph that opens with a bare “Yes.” or “No.”. whole-tree, globs, fail
check-base-r-tabs.yml Diff-scoped check that fails when a pull request adds or edits a panel-tabset that has an “R (tidymodels)” tab and no base R tab. whole-tree, globs, fail
check-bibliography-dois.yml Validate that book and article BibTeX entries have DOIs that resolve and match CrossRef metadata. install-quarto, no-metadata-check, exclude-keys, include-submodules, preinstalled-toolchain
check-caller-permissions.yml Whole-tree, blocking check that a workflow calls each Morrison-Lab/gha reusable workflow from a job that grants what the callee’s jobs request. workflows-dir, fail
check-citation-authors.yml Diff-scoped check that flags an author’s surname typed next to a citation of the same source. whole-tree, globs, paths-ignore, fail
check-code-fold.yml Diff-scoped check that fails when a pull request adds #\| code-fold: false to an executed code chunk. whole-tree, globs, fail
check-code-messages.yml Diff-scoped, warn-only check that keeps warnings and non-output messages out of rendered code. whole-tree, globs, fail
check-code-similarity.yml Flag code in a pull request that is highly similar to a caller-supplied corpus of prior submissions, using JPlag. path, corpus-path, base-code-path, language, threshold, fail, min-tokens, java-version, upload-report, timeout-minutes
check-contour-3d.yml Diff-scoped check that flags a contour or level-curve plot with no 3D surface plot of the same function. whole-tree, globs, paths-ignore, fail
check-corollary-sources.yml Diff-scoped, warn-only check for the lab’s rule (Ezra, 2026-11-16; psw’s Using theorem environments in Quarto section) that a corollary follows directly from one earlier result and names that result. whole-tree, globs, paths-ignore, fail
check-def-commentary.yml Diff-scoped, blocking check that flags commentary written inside a #def- div. whole-tree, globs, paths-ignore, fail
check-def-title-synonyms.yml Diff-scoped, warn-only check that flags the title of a definition div that lists synonyms with parentheses or “also called”. whole-tree, globs, fail
check-def-wiktionary.yml Diff-scoped, warn-only check that flags a definition div whose first bolded defined term is not linked to its Wiktionary entry. whole-tree, globs, fail
check-definite-antecedents.yml Diff-scoped heuristic that flags a div whose first sentence opens with a definite phrase and no link, and a demonstrative (this, that, these, those) standing alone as a pronoun (gha#1460). whole-tree, globs, paths-ignore, fail
check-definition-equations.yml Diff-scoped check for the lab’s rule (Ezra, 2026-10-29) that a definition div holds only the equation linking the symbol of the defined term to its definitional expression. whole-tree, globs, paths-ignore, fail
check-definition-expectation.yml Diff-scoped, warn-only heuristic check for the lab’s rule (Ezra, 2026-11-07; psw#513) to write a definition with an expectation operator where one fits: \E{\log \frac{1}{p(X)}}, not \sum_x p(x) \log \frac{1}{p(x)}. whole-tree, globs, paths-ignore, fail
check-dependency-graph.yml Run the self-test of a notes repository’s vendored build_dependency_graph.py, then build the graph of its definition and result divs and fail on a cycle. script-dir, pages-dir, site, fail-on-cycle
check-dependency-updates.yml Conduct automated dependency freshness audits on a repository. target-repo, dry-run, max-issues, labels, model, use-ai-config, timeout-minutes
check-div-ids.yml Diff-scoped, failing-by-default check that flags a fenced div with a theorem-type class but no id with the matching prefix. whole-tree, globs, paths-ignore, fail
check-duplicate-roxygen.yml Check for duplicate roxygen parameter documentation across R code files. path, paths-ignore, extensions, min-desc-length, base-ref, fail
check-equation-renders.yml Fourth leg of the PR-preview family, alongside preview.yml and preview-deploy.yml. fail, max-pages
check-exercise-background.yml Diff-scoped check, blocking by default, that flags an exercise whose title names a defined term that its body never mentions. whole-tree, globs, fail
check-exercise-before-result.yml Diff-scoped, blocking check that flags a result div added or edited without an exercise and its solution just before it. whole-tree, globs, paths-ignore, fail
check-exercise-ends-with-task.yml Diff-scoped check that fails a pull request which adds or edits an exercise that does not end with a question or an instruction. whole-tree, globs, fail
check-exercise-question-paragraph.yml Diff-scoped check that fails a pull request which adds a paragraph of an exercise that mixes scenario information with the instruction or question. whole-tree, globs, fail
check-exm-figures.yml Diff-scoped, blocking check that flags an example div (#exm-) with no figure. whole-tree, globs, paths-ignore, fail
check-extra.yml Extra R-package checks that R CMD check passes over. path, extra-packages, install-quarto, check-warnings, check-random-order, check-readme, check-readme-freshness
check-extracted-lemmas.yml Diff-scoped heuristic check for the lab’s rule (Ezra, 2026-10-29) to extract a lemma wherever feasible: a general fact that does not depend on its setting goes in its own #lem- div, on the site that owns the topic, and the proof or solution that uses it links to the lemma. whole-tree, globs, paths-ignore, fail
check-fform-paren.yml Diff-scoped, warn-only check that flags \name\paren{...} where an f form \namef{...} exists. whole-tree, macros-file, globs, paths-ignore, submodules, submodule-paths, fail
check-figure-placement.yml Diff-scoped, failing-by-default check that flags a figure a pull request adds when the page does not discuss it or places it away from its example. whole-tree, globs, paths-ignore, fail
check-format-output-files.yml Fails when a Quarto page lacks an output-file for a format that the repository’s publish renders with quarto render --to FORMAT. formats, globs, paths-ignore, fail
check-formatting.yml Fail when any R file in the caller would be rewritten by Air, Posit’s R formatter. version, path
check-function-graphs.yml Diff-scoped check that flags a definition of a function of one or two inputs with no graph of that function. whole-tree, globs, paths-ignore, fail
check-geometric-figures.yml Diff-scoped, blocking check that flags a geometric claim in prose with no figure nearby. whole-tree, globs, paths-ignore, window, fail
check-gradient-lhs.yml Diff-scoped, warn-by-default check for the lab’s gradient rule (psw#488, gha#1538): when a page states a gradient, it writes the symbol as the left-hand side of an equation, not “its gradient is …”. whole-tree, globs, paths-ignore, fail
check-heading-levels.yml Diff-scoped check that flags a heading that breaks its page’s outline. whole-tree, globs, paths-ignore, fail
check-heading-siblings.yml Diff-scoped, failing-by-default check that flags a heading a pull request adds to a group of too many sibling headings. whole-tree, globs, paths-ignore, max, min, fail
check-heading-titles.yml Diff-scoped check that flags a clickbait heading. whole-tree, globs, paths-ignore, fail
check-hybrid-sentences.yml Diff-scoped, failing-by-default heuristic check for the lab’s rule (Ezra, 2026-10-29) that a sentence is entirely in words or entirely in math. whole-tree, globs, paths-ignore, fail
check-informal-definitions.yml Flags technical concepts defined in running prose rather than inside formal Quarto definition divs (::: {#def-...}). path, globs, paths-ignore, fail, diff-scoped, base-ref, diff, output-markdown, output-json
check-iterate-subscripts.yml Diff-scoped check that flags an iterate written with a subscript, such as \vcoef_t or \vcoef_{t+1}. whole-tree, symbols, indices, globs, paths-ignore, fail
check-junk-files.yml Fail when the repository tracks operating-system or editor detritus – a .DS_Store written by Finder, an AppleDouble ._* sidecar, an .Rhistory or .RData an IDE left in the project root. patterns, paths-ignore, fail
check-key-equations-displayed.yml Diff-scoped check that fails when a pull request adds an inline equation in a proof that should be in display math. whole-tree, globs, fail
check-lab-exposition.yml Diff-scoped, blocking check that flags expository content added to a lab page. whole-tree, pages, prefixes, paths-ignore, fail
check-links.yml Run a lychee link check with a bundled config, a PR skip-label, and an auto-filed issue when links break on main. lychee-config, lychee-args, fail, fail-if-empty, create-issue-on-main, skip-label, fail-on-any-5xx
check-literal-math-letters.yml Diff-scoped, warn-only check that flags literal Latin and Greek letters in math where a semantic macro from Morrison-Lab/macros belongs. whole-tree, globs, paths-ignore, fail, mode, deprecated-files, letters, wrappers, submodules
check-local-macros.yml Diff-scoped, warn-only check that flags LaTeX macros defined outside Morrison-Lab/macros. whole-tree, globs, paths-ignore, override-files, library, submodules, submodule-paths, fail
check-macro-expansions.yml Diff-scoped, warn-only check that flags math which writes out by hand what a shared macro already says. whole-tree, macros-file, exclude, globs, paths-ignore, submodules, submodule-paths, fail
check-math-definitions.yml Check for duplicate, divergent, or colliding mathematical definitions and theorems across Quarto (.qmd) and Markdown (.md) files and sibling repositories. path, paths, repos, paths-ignore, extensions, prefixes, check-titles, fail
check-merge-drops.yml Reports content that a merge commit silently dropped. globs, paths-ignore, min-length, similarity, fail
check-multipart-exercises.yml Diff-scoped check that fails a pull request which adds or revises an exercise holding more than one part. whole-tree, globs, paths-ignore, fail
check-new-line-breaks.yml Diff-scoped check that flags newly-added Markdown lines packing more than one sentence/clause onto a single source line – the “semantic line breaks” convention (one clause/sentence per line), which keeps a diff scoped to the changed sentence instead of a whole reflowed paragraph. globs, paths-ignore, fail, clause-breaks, clause-min-length
check-news.yml Enforce a changelog entry on each pull request (wraps UCD-SERG/changelog-check-action). changelog, no-changelog-label
check-non-standard-chars.yml Detect curly quotes, en/em dashes, and the multiplication sign in .qmd, .R, and .md files, which can break Quarto and R rendering. extensions
check-note-sheet-rows.yml Diff-scoped check that flags a note-sheet table row holding more than one concept. whole-tree, globs, paths-ignore, fail
check-one-div-per-subfile.yml Diff-scoped, warn-only check that flags a Quarto subfile holding more than one top-level div. whole-tree, globs, paths-ignore, fail
check-one-function-per-file.yml Enforce the one-function-definition-per-file rule across repository code files (.R, .py, .sh, .js, .ts, .jl). path, paths-ignore, extensions, opt-out-comment, base-ref, fail
check-orphaned-images.yml Report tracked image files that no tracked source file references. paths, extensions, source-extensions, paths-ignore, added-only, fail
check-page-length.yml Diff-scoped, failing-by-default check that flags a page a pull request adds to when the page has grown too long. whole-tree, globs, paths-ignore, max-math, max-lines, fail
check-paired-file-change.yml Fail a pull request that changes a file matching trigger-paths without also changing a file matching required-paths, unless the PR carries the skip label. trigger-paths, required-paths, skip-label, message
check-phi.yml Scan pull requests (added lines only; the whole tracked tree on push) for content that looks like protected health information: US Social Security numbers, medical record numbers, dates of birth, study/participant identifier literals, and PHI-suggestive column headers in delimited data files. detectors, paths-ignore, allowlist-file, fail
check-pr-concerns.yml Diff-scoped, blocking check that fails a pull request changing both content and infrastructure. content-paths, infra-paths, paths-ignore, exempt-label, fail
check-pr-size.yml Diff-scoped, blocking check that fails a pull request changing more than 20 files or 600 lines. max-files, max-lines, paths-ignore, exempt-label, fail
check-precedence-parens.yml Diff-scoped check that flags math leaving the precedence of a logical connective implicit. whole-tree, globs, paths-ignore, fail
check-proof-statements.yml Diff-scoped, failing-by-default check for two of the lab’s proof rules (psw#426, gha#1351). whole-tree, globs, paths-ignore, fail
check-python-package.yml Bundles the standard check suite for Python package repositories. fail, check-junk-files, junk-patterns, junk-paths-ignore, check-secrets, secrets-config, secrets-paths-ignore, check-non-standard-chars, non-standard-chars-extensions, check-new-line-breaks, new-line-breaks-base-ref, new-line-breaks-globs, check-typos, typos-config, typos-base-ref, lint-yaml, yaml-config-file, yaml-paths-ignore, lint-workflows, workflows-path, lint-markdown, markdown-config-file, markdown-globs, markdown-paths-ignore, markdown-base-ref, check-ruff, check-formatting, ruff-args, check-tests, pytest-args
check-python-qmd-chunks.yml Diff-scoped check that lints the Python chunks of the .qmd files a pull request changes, with the repository’s Ruff configuration. config, whole-tree, globs, fail
check-quarto-book.yml Bundles the standard check suite for Quarto book repositories (such as Morrison-Lab/qbt). fail, check-junk-files, junk-patterns, junk-paths-ignore, check-secrets, secrets-config, secrets-paths-ignore, check-non-standard-chars, non-standard-chars-extensions, check-new-line-breaks, new-line-breaks-base-ref, new-line-breaks-globs, check-typos, typos-config, typos-base-ref, check-ai-tells, ai-tells-threshold, ai-tells-ignore, lint-yaml, yaml-config-file, yaml-paths-ignore, lint-workflows, workflows-path, lint-markdown, markdown-config-file, markdown-globs, markdown-paths-ignore, markdown-base-ref, lint-qmd, qmd-config-file, qmd-globs, qmd-paths-ignore, check-links, lychee-config, lychee-args, check-quarto-links, quarto-links-paths-ignore, check-orphaned-images, orphaned-images-paths-ignore, orphaned-images-base-ref, orphaned-images-fail, check-typed-output, typed-output-globs, typed-output-paths-ignore, typed-output-diff-scoped, typed-output-base-ref, typed-output-fail, check-informal-definitions, informal-definitions-globs, informal-definitions-paths-ignore, informal-definitions-diff-scoped, informal-definitions-base-ref, informal-definitions-fail, check-bibliography-dois, bib-exclude-keys, check-equation-renders, equation-renders-site-dir
check-quarto-links.yml Fail when a tracked .qmd, .md, or .Rmd file links to a page that does not exist, such as [Week 6](reference/week-06-logistic-regression.qmd) after that page was renamed. globs, target-extensions, paths-ignore, fail, check-fragments, partial-globs, external-targets, site-urls
check-quarto-manuscript.yml Bundles the standard check suite for Quarto manuscript and academic paper repositories (such as Morrison-Lab/qmt). fail, check-junk-files, junk-patterns, junk-paths-ignore, check-secrets, secrets-config, secrets-paths-ignore, check-non-standard-chars, non-standard-chars-extensions, check-new-line-breaks, new-line-breaks-base-ref, new-line-breaks-globs, check-typos, typos-config, typos-base-ref, check-ai-tells, ai-tells-threshold, ai-tells-ignore, lint-yaml, yaml-config-file, yaml-paths-ignore, lint-workflows, workflows-path, lint-markdown, markdown-config-file, markdown-globs, markdown-paths-ignore, markdown-base-ref, lint-qmd, qmd-config-file, qmd-globs, qmd-paths-ignore, check-links, lychee-config, lychee-args, check-quarto-links, quarto-links-paths-ignore, check-orphaned-images, orphaned-images-paths-ignore, orphaned-images-base-ref, orphaned-images-fail, check-typed-output, typed-output-globs, typed-output-paths-ignore, typed-output-diff-scoped, typed-output-base-ref, typed-output-fail, check-informal-definitions, informal-definitions-globs, informal-definitions-paths-ignore, informal-definitions-diff-scoped, informal-definitions-base-ref, informal-definitions-fail, check-bibliography-dois, bib-exclude-keys, check-equation-renders, equation-renders-site-dir
check-quarto-prose.yml Block a pull request that adds an idiom, cliche or slang phrase to a .qmd or .md file, or that puts an example, remark or definition in a notes div. globs, paths-ignore, base-ref, idioms-file, allow-file, fail
check-quarto-website.yml Bundles the standard check suite for Quarto website repositories (such as Morrison-Lab/qwt). fail, check-junk-files, junk-patterns, junk-paths-ignore, check-secrets, secrets-config, secrets-paths-ignore, check-non-standard-chars, non-standard-chars-extensions, check-new-line-breaks, new-line-breaks-base-ref, new-line-breaks-globs, check-typos, typos-config, typos-base-ref, check-ai-tells, ai-tells-threshold, ai-tells-ignore, lint-yaml, yaml-config-file, yaml-paths-ignore, lint-workflows, workflows-path, lint-markdown, markdown-config-file, markdown-globs, markdown-paths-ignore, markdown-base-ref, lint-qmd, qmd-config-file, qmd-globs, qmd-paths-ignore, check-links, lychee-config, lychee-args, check-quarto-links, quarto-links-paths-ignore, check-orphaned-images, orphaned-images-paths-ignore, orphaned-images-base-ref, orphaned-images-fail, check-typed-output, typed-output-globs, typed-output-paths-ignore, typed-output-diff-scoped, typed-output-base-ref, typed-output-fail, check-informal-definitions, informal-definitions-globs, informal-definitions-paths-ignore, informal-definitions-diff-scoped, informal-definitions-base-ref, informal-definitions-fail, check-bibliography-dois, bib-exclude-keys
check-r-head.yml Diff-scoped check that flags an R statement printing a dataset through head() in a data div, such as head(df) or df \|> head(). whole-tree, data-files, globs, paths-ignore, fail
check-r-package.yml Bundles the standard check suite for R package repositories (such as Morrison-Lab/rpt). fail, check-junk-files, junk-patterns, junk-paths-ignore, check-secrets, secrets-config, secrets-paths-ignore, check-non-standard-chars, non-standard-chars-extensions, check-new-line-breaks, new-line-breaks-base-ref, new-line-breaks-globs, check-typos, typos-config, typos-base-ref, check-ai-tells, ai-tells-threshold, ai-tells-ignore, lint-yaml, yaml-config-file, yaml-paths-ignore, lint-workflows, workflows-path, lint-markdown, markdown-config-file, markdown-globs, markdown-paths-ignore, markdown-base-ref, check-duplicate-roxygen, duplicate-roxygen-path, check-one-function-per-file, one-function-per-file-path, check-extra, extra-check, check-formatting, air-version, air-path
check-redundant-citations.yml Diff-scoped, warn-only check that flags a source cited twice in one div or passage. whole-tree, globs, paths-ignore, fail
check-removed-content.yml Diff-scoped check that fails a pull request that removes prose which reappears nowhere in the pull request. globs, min-overlap, min-words, fail
check-repo-hygiene.yml Bundles the standard repository hygiene check suite for Morrison-Lab repositories. fail, check-junk-files, junk-patterns, junk-paths-ignore, check-secrets, secrets-config, secrets-paths-ignore, check-non-standard-chars, non-standard-chars-extensions, check-new-line-breaks, new-line-breaks-base-ref, new-line-breaks-globs, check-typos, typos-config, typos-base-ref, lint-yaml, yaml-config-file, yaml-paths-ignore, lint-workflows, workflows-path, lint-markdown, markdown-config-file, markdown-globs, markdown-paths-ignore, markdown-base-ref
check-restated-results.yml Diff-scoped, warn-only heuristic check for the lab’s rule (Ezra, 2026-10-29) that a result first derived in an exercise solution is restated in its own theorem-type div (#thm-, #lem-, #cor- or #prp-) after the exercise. whole-tree, globs, paths-ignore, fail
check-result-definition-links.yml Diff-scoped, warn-only check for the lab’s rule (Ezra, 2026-11-09) that every result div links at least one definition. whole-tree, globs, paths-ignore, fail
check-results-in-remarks.yml Diff-scoped, warn-only heuristic check for the lab’s rule (Ezra, 2026-11-07; psw#512) that a remark holds commentary. whole-tree, globs, paths-ignore, fail
check-rubric-checklists.yml Diff-scoped check that warns when a pull request adds or revises a grading rubric that is not written as a checklist. whole-tree, globs, paths-ignore, fail
check-search-shortcut.yml Blocking check that flags a Quarto site whose search opens on Ctrl/Cmd-F or Ctrl/Cmd-S. globs, paths-ignore, fail
check-secrets.yml Scan the repository’s git history for committed credentials – API tokens, private keys, high-entropy password assignments – using gitleaks. version, checksums-sha256, config, paths-ignore, allowlist-file, log-opts, fail
check-self-contained-captions.yml Diff-scoped, blocking check that flags a figure or table caption whose first sentence only points to another div. whole-tree, globs, paths-ignore, fail
check-self-credits.yml Diff-scoped, warn-only check that flags a formal credit to the group’s own work. config, whole-tree, globs, paths-ignore, fail
check-self-reference.yml Diff-scoped check that flags self-referential prose. whole-tree, globs, paths-ignore, fail
check-serial-comma.yml Diff-scoped check that fails when a pull request adds a list of three or more items with no comma before the final “and” or “or”. whole-tree, globs, paths-ignore, fail
check-single-ask-parts.yml Diff-scoped check that warns when a pull request adds or revises an exercise part that asks for more than one thing. whole-tree, globs, paths-ignore, fail
check-solution-citations.yml Diff-scoped, blocking check that flags a citation of a solution inside a proof or result div. whole-tree, globs, paths-ignore, fail
check-source-overlap.yml Flag paragraphs of Markdown and Quarto prose that copy a reference text, as a guard against unintentional plagiarism by authors and AI agents alike. corpus-repo, corpus-files, base-ref, paths, paths-ignore, min-run, fail
check-split-solutions.yml Diff-scoped check that fails a pull request which touches a split exercise whose solution was not split with it. whole-tree, globs, paths-ignore, fail
check-static-figures.yml Diff-scoped check that flags an interactive figure with no noninteractive version in static formats. whole-tree, globs, paths-ignore, fail
check-tautological-equations.yml Diff-scoped, blocking check that fails when the two sides of an equality render identically once the shared macros are expanded. whole-tree, macros-file, globs, paths-ignore, submodules, submodule-paths, fail
check-term-links.yml Diff-scoped, blocking check that every technical term is linked to its definition the first time it appears in each div, or in the prose outside divs between one heading and the next. whole-tree, globs, paths-ignore, terms-file, terms-from, allow-file, fail
check-title-references.yml Diff-scoped check that flags a reference to a section, chapter, or page by its title that does not name the content type. whole-tree, globs, paths-ignore, fail
check-tree-lists.yml Diff-scoped, blocking check that flags a tree written only as a nested list. whole-tree, globs, paths-ignore, fail
check-typed-output.yml Flags typed (“faked”) code output in Quarto sources. patterns, globs, paths-ignore, fail, diff-scoped
check-typos.yml Diff-scoped spellcheck of the files spellcheck.yml cannot see – a Quarto site’s non-vignette .qmd pages, CONTRIBUTING.md-class Markdown, docs/, YAML, code comments, and repositories that are not R packages – with crate-ci/typos. version, checksums-sha256, path, config, globs, paths-ignore, base-ref, fail
check-unexplained-choices.yml Diff-scoped check that fails when a binning choice in code is never explained by the prose around it. whole-tree, globs, paths-ignore, fail
check-unexplained-contrasts.yml Diff-scoped check that flags a contrast in a definition, remark or note that cites no source. whole-tree, globs, paths-ignore, fail
check-visualization-figures.yml Diff-scoped, blocking check that flags a div that asks for a picture but has no figure. whole-tree, globs, paths-ignore, fail
check-wikipedia-further-reading.yml Diff-scoped, blocking check that flags a Wikipedia citation or link in a list item of a Further reading section. whole-tree, globs, paths-ignore, fail
check-write-idiom.yml Diff-scoped, failing-by-default check that flags a line opening with Write the, Write a or Write an. whole-tree, globs, paths-ignore, fail
claude.yml Run the agent-mode Claude Code bot. setup-r, install-quarto, apt-packages, pip-packages, use-renv, r-extra-packages, renv-cache-version, checkout-submodules, link-skills, eager-pr, reviewer, review-workflow-file, dispatch-review-on-agent-push, mark-ready-for-review, prompt-addendum, webfetch-allowlist-url, use-ai-config, use-posit-skills, plugin-marketplaces, plugins, reference-repos, reference-repos-token, claude-args, report-cost, trusted-bot-logins, dispatch-on-assignee, extra-secret-names, timeout-minutes
claude-code-review.yml Run a read-only Claude review of a pull request (the code-review plugin). gate-runs-on, pr-number, prompt-addendum, checkout-submodules, submodule-paths, allowed-bots, track-progress, show-full-output, apt-packages, pip-packages, lab-manual, check-latex-macros, report-cost, model, use-ai-config, use-posit-skills, plugin-marketplaces, plugins, reference-repos, reference-repos-token, extra-secret-names, timeout-minutes
claude-manage-project.yml Triage a newly-opened issue: apply a priority label, and add the issue to the repository’s project board where the token allows. prompt-addendum, trusted-bot-logins
cleanup-pr-previews.yml The housekeeping half of the PR-preview family. preview-dir, compact-history, publish-workflow, wait-for-publish, idle-days
cursor-code-review.yml Queue a Cursor Bugbot review for a pull request. pr-number, dry-run
gemini.yml Agent-mode Gemini CLI bot. setup-r, install-quarto, use-renv, renv-cache-version, r-extra-packages, apt-packages, pip-packages, checkout-submodules, eager-pr, reviewer, mark-ready-for-review, prompt-addendum, gemini-model, review-workflow-file, extra-secret-names
gemini-code-review.yml Read-only Gemini PR code review. pr-number, prompt-addendum, checkout-submodules, gemini-model, extra-secret-names
lint-changed-files.yml Run lintr at one of three scopes, selected by the scope input: scope, path, linter-file, install-quarto, use-renv, renv-cache-version, apt-packages, extra-packages, install-package, fail, preinstalled-toolchain
lint-changed-lines.yml Run lintr over the R files a pull request changes, but report only the lints on lines the PR actually added or modified – not whole changed files. path, install-quarto, use-renv, renv-cache-version, apt-packages, extra-packages, install-package, fail, file-pattern, lms-ref
lint-markdown.yml Lint tracked Markdown files with markdownlint-cli2 using a bundled default config (overridable), plus companion checks that flag fenced code blocks longer than a configurable line threshold, list-item merge splices, and blank lines that split a GFM table. config-file, globs, paths-ignore, fail, max-code-block-lines, fail-on-long-code-blocks, base-ref, fail-on-item-splices, fail-on-table-splits
lint-qmd.yml Lint the prose sections of tracked .qmd Quarto files with markdownlint. config-file, globs, paths-ignore, fail, max-line-length
lint-workflows.yml Audit the caller’s GitHub Actions workflows and composite actions with actionlint (syntax/semantics – unknown keys, bad runs-on labels, invalid expression syntax, shellcheck over run: blocks) and zizmor (security – template-injection sinks, credential persistence, overly broad permissions, unpinned actions). path, actionlint-version, actionlint-checksum, zizmor-version, pedantic, fail
lint-yaml.yml Lint tracked YAML files with yamllint using a bundled default config (overridable), plus a companion check that flags run: script blocks in workflow/action YAML longer than a configurable line threshold, so they get decomposed into a separate script file the way this repo’s own R/Python capabilities already do. config-file, paths-ignore, fail, max-script-lines, fail-on-long-scripts
opencode-code-review.yml Read-only OpenCode PR code review, run through the opencode CLI headless. pr-number, prompt-addendum, checkout-submodules, opencode-model, opencode-version, opencode-attempts
opposition-research.yml Conduct automated opposition research on a competitor product, framework, or repository. competitor, target-repo, scope-guidance, dry-run, max-issues, labels, model, use-ai-config, timeout-minutes
preview.yml The build half of the PR-preview family. path, r-version, apt-packages, use-renv, r-packages, install-package, setup-chrome, tinytex, setup-julia, preinstalled-toolchain, julia-version, submodules, render-profile, output-dir, formats, skip-docx, skip-formats, incremental, cluster-render, cluster-head, cluster-image, cluster-image-file, cluster-idle-minutes, extra-preview-labels, fail-on-render-warning, forbid-log-patterns, post-build-command, post-build-continue-on-error, timezone, timeout-minutes, detect-changed-chapters, changed-chapters-banner, highlight-changes, changed-chapters-glob, deployed-branch, deployed-subdir, changed-chapters-normalize-patterns, max-elements-for-pairwise, banner-index, docx-tracked-changes, docx-tracked-changes-glob
preview-deploy.yml The deploy half of the PR-preview family. pages-base-url, pages-base-path
quarto-publish.yml Render a Quarto project and deploy it to the gh-pages branch, which GitHub Pages serves. path, setup-r, r-packages, use-renv, install-package, setup-chrome, tinytex, preinstalled-toolchain, setup-julia, julia-version, apt-packages, output-dir, render-profile, formats, per-file-formats, freeze-cache, incremental-cache, freeze-cache-save-on-failure, deno-v8-options, fail-on-render-warning, forbid-log-patterns, timezone, cluster-render, cluster-head, cluster-image, cluster-image-file, timeout-minutes, checkout-submodules, pre-render-artifact, pre-render-artifact-path, deploy
r-cmd-check.yml Run R CMD check across an OS x R-version matrix, wrapping r-lib/actions setup-r, setup-r-dependencies, and check-r-package. hard, extra-packages, error-on, cran-incoming-remote, force-suggests, stop-on-invalid-numeric-version-inputs, path, config, setup-pandoc, install-quarto, setup-julia, julia-version, julia-project, apt-packages, brew-packages, brew-casks, linux-container, checkout-submodules, timeout-minutes, build-args, upload-snapshots, upload-results, cluster-check, cluster-runs-on, cluster-head, cluster-image, cluster-image-file
report-failure.yml File an issue when a workflow fails, or comment on the issue already open for that failure. title, body, labels
report-main-failure.yml Follow up when a workflow fails on the default branch. labels
request-dependabot-review.yml Request review from a configurable list of reviewers when a PR’s author matches a bot actor (Dependabot by default), so scheduled dependency bumps don’t merge without a human look. reviewers, bot-actor
small-model-agent.yml Run a small, self-hosted (or OpenAI-compatible API endpoint) AI agent against a pull request, enforcing bounded retries against pre-check repository verification gates (YAML/Markdown linting, PHI tripwire scans) (gha#436, gha#415). pr-number, endpoint-url, model, max-iterations, setup-r, install-quarto, apt-packages, pip-packages, checkout-submodules, run-gates, dry-run, extra-secret-names
spellcheck.yml Spellcheck an R package’s prose with the {spelling} package. path, exclude, fail, additional-options, install-quarto, preinstalled-toolchain
student-qmd.yml Writes the .qmd files a course can hand to students, from assessment sources that keep each answer beside its question. sources, working-directory, output-dir, hidden-classes, answer-profiles, student-profile, drop-render-chunks, prune-macros, drop-front-matter-keys, require-answers, check, render, render-to, index-title, index-back-href, quarto-version, checkout-submodules, artifact-name
summary.yml Post a Claude summary comment on newly opened issues. model
sync-shared-fragments.yml Vendor a set of files from an upstream repo, pinned to a commit and recorded in a JSON manifest, and open a PR when the copy changes. source-repo, source-ref, source-paths, dest-dir, dest-files, manifest-path, base-branch, pr-branch
sync-upstream.yml Merge an upstream repository’s branch into this fork and open a PR when the merge brings changes. upstream-repo, upstream-branch, base-branch, pr-branch, fail-on-conflict
test-coverage.yml Measure R-package test coverage with {covr} and upload the Cobertura report to Codecov. path, install-quarto, extra-packages, fail-ci-if-error, upload-test-results, examples-coverage, min-coverage, cluster-check, cluster-runs-on, cluster-head, cluster-image, cluster-image-file
triage-backlog.yml Backlog triage that labels and never closes. dry-run, ceiling, limit
update-quarto-extensions.yml Update vendored Quarto extensions in-place to upstream semver tags and open or refresh an automation pull request when newer versions are available. extension-repos, extensions-dir, base-branch, pr-branch, labels, dry-run, allow-local-edits
update-snapshots.yml Regenerate testthat snapshots for an R package: run the test suite, accept the output the code now produces (testthat::snapshot_accept()), re-run the tests, then commit and push the changed files under tests/testthat/_snaps/. ref, pr-mode, julia, julia-version, julia-project, extra-packages, needs, apt-packages, preinstalled-toolchain, commit-message, committer-name, committer-email
version-check.yml Fail a PR whose DESCRIPTION Version: differs from the base branch’s. description-path, no-version-increment-label, bump-branch, preinstalled-toolchain

Choosing the runner. Every check-* and lint-* workflow that takes no secrets, plus check-secrets.yml, cleanup-pr-previews.yml and annotation-gate-run.yml, accepts a runs-on input (default empty: the caller’s CI_RUNNER variable if set, else ubuntu-latest), so a private repository that sets CI_RUNNER to its self-hosted label runs every gha job there while GitHub-hosted minutes are unavailable. gha ignores CI_RUNNER for a public repository’s events (it reads github.event.repository.private), but leave it unset at the repository and the organization level in every public repository anyway. preview.yml and the build job of quarto-publish.yml read a CI_RUNNER_HEAVY variable before CI_RUNNER, so a private repository can send its renders to a different runner label (#1563). Never point a public repository at a self-hosted runner, because a pull request from a fork can run arbitrary code on it (#1167).

Versioning

@v1 was frozen at the pre-2.0.0 snapshot when the breaking quarto-publish change cut @v2, so any capability pinned there has picked up no fixes since - including non-breaking ones, like cleanup-pr-previews’s compact-history input, which does not exist at @v1 at all.

Versioning lists the tag each capability pins, generated from its stub in examples/.

quarto-publish.yml additionally has a genuine behavioral fork: @v1 stays frozen on the older GitHub Actions Pages-artifact deploy, while @v2 deploys to the gh-pages branch instead - required if the same repo also uses the PR-preview family, since Pages can only have one Source. check-bibliography-dois.yml, check-phi.yml, check-links.yml, check-non-standard-chars.yml, claude.yml, and claude-code-review.yml also pin @v2: each picked up a real fix since the freeze (a dependency-pin bump, a new input, or a security fix) that a consumer still on @v1 would miss (audited in gha#182). request-dependabot-review.yml only ever shipped at @v2 too (it postdates the freeze - see gha#252), as does sync-upstream.yml (added after the freeze - see gha#254), altdoc-multiversion-docs.yml (added after the freeze), and report-failure.yml (added after the freeze - see gha#325). gemini.yml, gemini-code-review.yml, antigravity-code-review.yml, cursor-code-review.yml, opencode-code-review.yml, and ai-code-review.yml likewise only ever shipped at @v2, having been added well after the freeze - see gha#357, gha#510, and gha#586. bump-dev-version.yml and version-check.yml postdate the freeze too (added in gha#388); pin both to @v2. small-model-agent.yml postdates the freeze too (added in gha#436); pin to @v2. check-ai-tells.yml postdates the freeze too (added in gha#382); pin to @v2. bump-submodule.yml and sync-shared-fragments.yml were audited in the same pass and found unchanged since the freeze, so @v1 stayed current for them then; sync-shared-fragments.yml has since moved to @v3. check-news.yml was initially grouped with them, but later gained the configurable no-changelog-label input at gha#143 - pin it to @v2 too. The stubs in examples/ carry the tag and permissions: block documented on each workflow’s own reference page; copy the specific stub you need as-is.

Quality checks

These run on pull requests (and often on main) to keep a repo’s content clean.

  • check-ai-tells.yml scans narrative prose in Markdown and Quarto files for AI tell patterns and density.

  • check-bibliography-dois.yml confirms BibTeX entries have DOIs that resolve and match CrossRef metadata.

  • check-junk-files.yml fails when the repository tracks operating-system or editor detritus – a .DS_Store, an AppleDouble ._* sidecar, an .Rhistory or .RData. It reports each file, the git rm --cached line that clears it, and the per-machine fix that stops it recurring in every other repository too.

  • check-math-definitions.yml scans Quarto and Markdown sources for duplicate, divergent, or colliding math definitions and theorems across files and sibling repositories.

  • check-non-standard-chars.yml flags curly quotes, en/em dashes, and the multiplication sign in .qmd, .R, and .md files, which can break Quarto and R rendering. The multiplication sign’s ASCII replacement depends on context: x or * in

    code, and $\times$ or &times; in prose, since Pandoc renders a \uXXXX escape literally rather than decoding it.

  • check-links.yml runs a lychee link check with a bundled config, a PR skip-label, and an auto-filed issue when main breaks.

  • check-quarto-links.yml fails on a relative link from a .qmd, .md, or .Rmd source to a page that does not exist. Quarto only warns about such a link (Unable to resolve link target), and lychee reads a .qmd as plain text, so check-links.yml never sees it. It reads the sources, so no render is needed, and it resolves a link in an included subfile from the page that includes it, as Quarto does.

  • check-quarto-prose.yml blocks a pull request that adds an idiom, cliche or slang phrase to a .qmd or .md file, or that puts an example, remark or definition in a notes div. It reports only the lines a diff adds.

  • check-orphaned-images.yml reports tracked images that no tracked source file names, warning by default.

  • check-news.yml enforces a NEWS.md changelog entry on each PR.

  • lint-yaml.yml runs yamllint over tracked YAML with a bundled config, plus a check that flags long run: script blocks as decomposition candidates.

  • lint-markdown.yml runs markdownlint-cli2 over tracked Markdown with a bundled config, plus a check that flags long fenced code blocks as decomposition candidates.

  • lint-qmd.yml runs markdownlint over the prose sections of tracked .qmd Quarto files; code chunks are stripped before linting and YAML front matter is skipped natively. A default 80-char line-length ceiling encourages semantic line breaks.

  • lint-changed-lines.yml runs lintr over only the lines a pull request adds or modifies (not whole changed files), so lint rules can be adopted or tightened incrementally: new and edited code must comply while untouched legacy code is left alone. file-pattern extends the check to Quarto and R Markdown documents, linting their R chunks, and lms-ref installs the shared lms package and lints with lms::default_linters(nested_calls = TRUE), the lab’s linters including the no-nested-calls rules.

  • lint-changed-files.yml runs lintr at one of three scopes selected by scope: the files a pull request changed (default), a whole package (lintr::lint_package()), or a whole project (lintr::lint_dir()). lintr is installed from CRAN, not GitHub HEAD.

  • check-formatting.yml runs air format --check -- <path> via posit-dev/setup-air. Air is Posit’s R formatter, a Rust binary, so there is no R session to start. It complements lint-changed-lines.yml: Air settles layout, lintr decides the rest of R style. Check-only – it never rewrites the branch. Adopting it in a repo that is not already Air-formatted is a large first-pass diff; commit an air.toml first (empty is enough), run air format and commit that rewrite on its own, then enable the check.

  • check-phi.yml scans for content that looks like protected health information; see below.

  • check-secrets.yml scans the repository’s git history for committed credentials; see below.

  • spellcheck.yml spellchecks an R package’s prose with the {spelling} package, treating the package’s own inst/WORDLIST as the accepted vocabulary. It reads DESCRIPTION’s Title and Description fields, man/*.Rd, vignette sources (.Rmd, .qmd, .Rnw), and root README/NEWS/CHANGES/index Markdown – so a Quarto site’s other pages, and any repo that is not an R package, are out of its reach. It replaces the bespoke check-spelling.yaml several lab repos carry, and needs no wordlist migration, since that file is {spelling}’s own format.

  • check-typos.yml spellchecks those remaining files with crate-ci/typos: a Quarto site’s non-vignette pages, CONTRIBUTING.md-class Markdown, YAML, code comments, and repositories that are not R packages. Diff-scoped by default (only lines a PR adds, plus filename typos on paths the PR added or renamed), so a first run over an existing repo does not reflag years of drift; pass base-ref: all to scan the whole tree.

  • test-coverage.yml measures R-package test coverage with covr and uploads the Cobertura report to Codecov; pass the CODECOV_TOKEN secret through the caller’s secrets: block (optional for public repos, but recommended). Set examples-coverage: true for a second job that runs examples and vignettes. \dontrun{} does not run under R CMD check by default (only with --run-dontrun, which --as-cran does not imply); \donttest{} is skipped unless --as-cran or --run-donttest. That job does not upload to Codecov, produce a JUnit report, or apply min-coverage. On failure it uploads examples-coverage-test-failures. The percent appears in the log and step summary. Enabling it adds a check named <caller job> / Examples and vignettes coverage. Set min-coverage to fail the tests job when coverage falls below a chosen percent (empty/off by default). It does not apply to the examples job.

  • check-extra.yml runs three R-package checks that R CMD check passes over: warnings as errors on examples, tests, and vignettes; tests in random order with a logged seed; and a README.Rmd render that also fails when the knitted README.md is stale. Each check is its own job so every failure surfaces at once.

  • r-cmd-check.yml runs R CMD check across an OS x R-version matrix (r-lib’s 5-way default). A second caller job with hard: true runs a Depends/Imports/LinkingTo-only check on pull requests, with cache: false so a restored pak cache cannot silently contain Suggests.

PHI scanning

check-phi is a heuristic tripwire, not a HIPAA compliance tool. It flags patterns that should almost never be committed: US Social Security numbers, medical record numbers, dates of birth, study/participant identifier literals, and PHI-suggestive column headers in delimited data files (.csv/.tsv/.psv), so a human reviews before the data merges. It is tuned for high precision, so it misses free-text PHI such as patient names.

  • Diff-scoped on PRs. Only lines added by the PR are scanned; push scans the whole tracked tree.
  • Values are never printed. Findings report only file:line:col and the detector name, never the matched text, because a leaked identifier in a CI log is still a leak.
  • Suppressing false positives. Add a phi-allow comment on the line, or list a regex in an allowlist file (defaults to .github/phi-allowlist.txt). Use fail: false to downgrade findings to warnings.

The phone and email detectors exist but are off by default because they are noisy in source; enable them through the detectors input.

Secret scanning

check-secrets is check-phi’s counterpart for credentials: check-phi detects identifiers and has no notion of a password or a token, so a committed credential passes it cleanly.

  • It scans history, not the diff. A secret committed and then removed in a later commit is still exposed, because the orphaned commit stays fetchable through the GitHub API until the repository is garbage-collected. So the caller checks out with fetch-depth: 0, and a shallow clone is refused rather than reported clean on a partial scan.
  • Values are never printed, in the log or the run summary. Findings report only the rule, file:line, and the commit.
  • It blocks by default, where non-blocking prose checks only annotate.
  • Its paths-ignore patterns are Go regexes matched unanchored, not globs, so docs suppresses every path containing that substring; anchor with ^ when that matters.

It complements GitHub’s native secret scanning rather than replacing it – that is a repository setting evaluating pushes, not a pull-request check – and neither substitutes for rotating an exposed credential. See check-secrets.yml for the full reference.

Quarto sites

This family builds and ships Quarto sites, and it builds this very site.

  • quarto-publish.yml renders a Quarto project and deploys it to the gh-pages branch on main. One-time setup: set Settings -> Pages -> Source to “Deploy from a branch”, branch gh-pages / (root).
  • The preview family publishes a rendered site for each open PR to a pr-preview/pr-<n>/ directory on gh-pages. It is four cooperating workflows:
    1. preview.yml (build) renders the site and uploads it plus PR metadata as an artifact. It runs read-only in the possibly-forked PR context, so it cannot write to the base repo.
    2. preview-deploy.yml (deploy) triggers on the build’s workflow_run completion, downloads the artifact, and publishes it to gh-pages in the base-repo context, then comments the preview link.
    3. check-equation-renders.yml also triggers on the build’s workflow_run completion, downloads the same artifact, and crawls it with a headless browser to catch equations MathJax can’t typeset – invisible in the Quarto/pandoc build log, since MathJax only runs client-side.
    4. cleanup-pr-previews.yml (housekeeping) runs on a schedule and removes preview directories for PRs that have closed.

The build/deploy split is a trust boundary: untrusted fork code only ever runs in the read-only build half, while the privileged gh-pages push happens in the deploy half against base-repo code. Do not collapse them into one job. Repos with custom build sequences can keep a bespoke build workflow and still use preview-deploy.yml and cleanup-pr-previews.yml by uploading the three-file pr-preview-site artifact (site/, meta/pr-number.txt, meta/action.txt). See Partial adoption and artifact contract.

Two wiring requirements:

  • Both the deploy stub’s and the equation-check stub’s on: workflow_run: workflows: value must match the build stub’s name:. That string is how workflow_run finds the build.
  • workflow_run and schedule triggers only fire for the copy of the file on the default branch, so previews and cleanup do not take effect until the stubs merge to main.

This repo dogfoods all five. The caller stubs live in .github/workflows/: website-publish.yml, website-preview.yml, website-preview-deploy.yml, website-check-equation-renders.yml, and website-preview-cleanup.yml. They render this pure-markdown site with the R machinery turned off (no renv, no R CMD INSTALL, no Chrome).

Claude bots

The two Claude workflows are a pair.

  • claude.yml runs the agent-mode Claude Code bot: it responds to @claude mentions, edits files, and opens or updates PRs. A mention inside a code span, fence, or blockquote is not an invocation: a cheap mention-filter job runs detect-bot-mention and withholds the agent job (gha#554).
  • claude-code-review.yml runs a read-only Claude review: a consolidated summary on dispatched runs by default; add a pull_request trigger in the caller if you also want automatic reviews on PR updates (GitHub suppresses pull_request runs for conflicting PRs; gha#859). The model job’s GITHUB_TOKEN has no write scopes (contents / pull-requests / issues / actions / checks: read); jobs that hold pull-requests: write / issues: write never invoke the model (gha#580). The caller still grants actions: read: post-review downloads the packed artifact, and a permissions: block sets unspecified scopes to none. The caller is also asked to grant checks: read, which GET .../commits/{ref}/check-runs needs and actions: read does not cover (gha#829). Grant it, and keep it granted. It is optional under the currently-tagged @v2 (which no longer requests it, per gha#832) but required by the model job once you adopt @v3. The model job briefly gave the scope up, because a called workflow cannot request a permission its caller lacks, so requesting one startup-fails every caller without it (gha#831). The scope is back on the model job in v3, now that the caller-side grant above is established practice – a caller already granting it moves to @v3 at no cost.

An @claude review mention (or any commit Claude pushes) routes through claude.yml, which dispatches claude-code-review.yml via workflow_dispatch. Install both, and keep the review stub named claude-code-review.yml (or set claude.yml’s review-workflow-file input to match) so the dispatch resolves. If you also want the direct /review path, enable issue_comment in the review stub too. Enabling issue_comment is required for either comment path, since dispatch-on-comment only ever runs on that event. If you have disabled claude.yml, enable it and also set the repository variable CLAUDE_AGENT_DISABLED to true, so an @claude review mention dispatches a review from the stub rather than reaching a workflow that no longer answers it.

gemini.yml and gemini-code-review.yml are the same pair for Gemini CLI, with the same division of labour: the agent answers @gemini and @gemini-cli mentions, and an @gemini review dispatches the reviewer rather than being answered in place. Keep the review stub named gemini-code-review.yml (or set gemini.yml’s review-workflow-file to match). Gemini needs a GEMINI_API_KEY secret; the two families are independent, so a repo can install either or both.

cursor-code-review.yml queues a Cursor Bugbot review through the Enterprise Bugbot API. It is not a mention bot: there is no cursor.yml counterpart. Team and individual Cursor plans should enable Bugbot in the dashboard (automatic reviews, or a PR comment cursor review / bugbot run) instead of this workflow. A Team-plan CURSOR_API_KEY fails the queue step with HTTP 401 Invalid Team API Key (gha#601); do not debug caller secret wiring for that signature. Add cursor to ai-code-review.yml’s agents input when CURSOR_API_KEY is set and the caller stub is installed.

opencode-code-review.yml runs the opencode CLI headless as a read-only reviewer: the diff arrives as an attachment, the agent reads the checkout for context, and its review is posted by the workflow itself. There is no opencode.yml mention bot yet (tracked in gha#586’s deferred follow-ups), so reviews arrive via pull_request, ai-code-review.yml dispatch, or manual workflow_dispatch. Add the OPENCODE_API_KEY secret (OpenCode Zen) and add opencode to ai-code-review.yml’s agents input.

All agent workflows align with upstream action standards (such as anthropics/claude-code-action v1.0.191 and run-gemini-cli v0.1.22, alongside the google-antigravity Python SDK) for trigger policies, permission isolation, and secret handling. In particular, central workflows (claude.yml, claude-code-review.yml) and the review attempt composite action (run-claude-review-attempt) were audited against upstream reference templates in anthropics/claude-code-action:

  • Action input forwarding. Upstream inputs such as claude_code_oauth_token, anthropic_api_key, show_full_output, and allowed_bots are forwarded cleanly, with use_sticky_comment: 'false' hardcoded in run-claude-review-attempt so each push surfaces fresh PR activity.
  • Permission isolation. In agent mode, review runs enforce read-only execution by disallowing git-write tools (git add, git commit, git rm, git push, and gh pr comment) while allowlisting inline comments and read-only tools (gh pr view, gh pr diff, WebFetch, WebSearch).
  • Execution guards. Single-turn verdicts are requested in system prompt addenda, while pre-flight credential checks and post-run execution checks gracefully handle unconfigured secrets or exhausted quota (#395).

ai-code-review.yml sits above whichever review workflows a repo has installed: it picks one of the configured agents at random and dispatches that agent’s own review workflow, falling through to the next candidate when one can’t be dispatched (no API key or token secret configured for it, or its review workflow file missing or disabled in the caller repo) as well as an agent run that fails or is cancelled during execution (gha#362, gha#444).

Content sync

Three workflows keep a repo current with content that lives elsewhere, without hand-bumping. The first two are the two directions of sharing single-source-of-truth content between a pair of repos; the third tracks an upstream a fork was cut from.

  • bump-submodule.yml is for the side that vendors the other repo as a git submodule. A scheduled run advances the submodule to its upstream HEAD and opens a PR when it moved.
  • sync-shared-fragments.yml is for the side that cannot add a submodule because the other repo already submodules it (a mutual submodule would recurse). It vendors a pinned copy of the named files into a dest-dir, records the source repo and commit in a JSON manifest, and opens a PR when the copy changes.
  • sync-upstream.yml is for a fork that tracks the project it was cut from. A scheduled run merges the upstream branch into a fork-owned automation branch and opens a PR when the merge brings changes, so the fork’s own changes are preserved and upstream’s updates are reviewed before they land. On a clean merge the PR is mergeable; on a conflict it carries the conflict markers for manual resolution.

All three reuse the open-sync-pr composite, which commits staged changes to a reused automation branch and opens or updates one PR (a no-op when nothing changed). For bump-submodule.yml/sync-shared-fragments.yml, scope each side to the other repo’s shared content so the two auto-PRs do not ping-pong.