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.ymlscans narrative prose in Markdown and Quarto files for AI tell patterns and density.check-bibliography-dois.ymlconfirms BibTeX entries have DOIs that resolve and match CrossRef metadata.check-junk-files.ymlfails when the repository tracks operating-system or editor detritus – a.DS_Store, an AppleDouble._*sidecar, an.Rhistoryor.RData. It reports each file, thegit rm --cachedline that clears it, and the per-machine fix that stops it recurring in every other repository too.check-math-definitions.ymlscans Quarto and Markdown sources for duplicate, divergent, or colliding math definitions and theorems across files and sibling repositories.check-non-standard-chars.ymlflags curly quotes, en/em dashes, and the multiplication sign in.qmd,.R, and.mdfiles, which can break Quarto and R rendering. The multiplication sign’s ASCII replacement depends on context:xor*incode, and
$\times$or×in prose, since Pandoc renders a\uXXXXescape literally rather than decoding it.check-links.ymlruns a lychee link check with a bundled config, a PR skip-label, and an auto-filed issue whenmainbreaks.check-quarto-links.ymlfails on a relative link from a.qmd,.md, or.Rmdsource to a page that does not exist. Quarto only warns about such a link (Unable to resolve link target), and lychee reads a.qmdas plain text, socheck-links.ymlnever 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.ymlblocks a pull request that adds an idiom, cliche or slang phrase to a.qmdor.mdfile, or that puts an example, remark or definition in a notes div. It reports only the lines a diff adds.check-orphaned-images.ymlreports tracked images that no tracked source file names, warning by default.check-news.ymlenforces aNEWS.mdchangelog entry on each PR.lint-yaml.ymlruns yamllint over tracked YAML with a bundled config, plus a check that flags longrun:script blocks as decomposition candidates.lint-markdown.ymlruns markdownlint-cli2 over tracked Markdown with a bundled config, plus a check that flags long fenced code blocks as decomposition candidates.lint-qmd.ymlruns markdownlint over the prose sections of tracked.qmdQuarto 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.ymlruns 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-patternextends the check to Quarto and R Markdown documents, linting their R chunks, andlms-refinstalls the sharedlmspackage and lints withlms::default_linters(nested_calls = TRUE), the lab’s linters including the no-nested-calls rules.lint-changed-files.ymlruns lintr at one of three scopes selected byscope: 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.ymlrunsair 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 complementslint-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 anair.tomlfirst (empty is enough), runair formatand commit that rewrite on its own, then enable the check.check-phi.ymlscans for content that looks like protected health information; see below.check-secrets.ymlscans the repository’s git history for committed credentials; see below.spellcheck.ymlspellchecks an R package’s prose with the {spelling} package, treating the package’s owninst/WORDLISTas the accepted vocabulary. It readsDESCRIPTION’sTitleandDescriptionfields,man/*.Rd, vignette sources (.Rmd,.qmd,.Rnw), and rootREADME/NEWS/CHANGES/indexMarkdown – so a Quarto site’s other pages, and any repo that is not an R package, are out of its reach. It replaces the bespokecheck-spelling.yamlseveral lab repos carry, and needs no wordlist migration, since that file is {spelling}’s own format.check-typos.ymlspellchecks 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; passbase-ref: allto scan the whole tree.test-coverage.ymlmeasures R-package test coverage withcovrand uploads the Cobertura report to Codecov; pass theCODECOV_TOKENsecret through the caller’ssecrets:block (optional for public repos, but recommended). Setexamples-coverage: truefor a second job that runs examples and vignettes.\dontrun{}does not run underR CMD checkby default (only with--run-dontrun, which--as-crandoes not imply);\donttest{}is skipped unless--as-cranor--run-donttest. That job does not upload to Codecov, produce a JUnit report, or applymin-coverage. On failure it uploadsexamples-coverage-test-failures. The percent appears in the log and step summary. Enabling it adds a check named<caller job> / Examples and vignettes coverage. Setmin-coverageto 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.ymlruns three R-package checks thatR CMD checkpasses over: warnings as errors on examples, tests, and vignettes; tests in random order with a logged seed; and aREADME.Rmdrender that also fails when the knittedREADME.mdis stale. Each check is its own job so every failure surfaces at once.r-cmd-check.ymlrunsR CMD checkacross an OS x R-version matrix (r-lib’s 5-way default). A second caller job withhard: trueruns a Depends/Imports/LinkingTo-only check on pull requests, withcache: falseso 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;
pushscans the whole tracked tree. - Values are never printed. Findings report only
file:line:coland 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-allowcomment on the line, or list a regex in an allowlist file (defaults to.github/phi-allowlist.txt). Usefail: falseto 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-ignorepatterns are Go regexes matched unanchored, not globs, sodocssuppresses 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.ymlrenders a Quarto project and deploys it to thegh-pagesbranch onmain. One-time setup: set Settings -> Pages -> Source to “Deploy from a branch”, branchgh-pages/(root).- The preview family publishes a rendered site for each open PR to a
pr-preview/pr-<n>/directory ongh-pages. It is four cooperating workflows: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.preview-deploy.yml(deploy) triggers on the build’sworkflow_runcompletion, downloads the artifact, and publishes it togh-pagesin the base-repo context, then comments the preview link.check-equation-renders.ymlalso triggers on the build’sworkflow_runcompletion, 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.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’sname:. That string is howworkflow_runfinds the build. workflow_runandscheduletriggers only fire for the copy of the file on the default branch, so previews and cleanup do not take effect until the stubs merge tomain.
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.ymlruns the agent-mode Claude Code bot: it responds to@claudementions, edits files, and opens or updates PRs. A mention inside a code span, fence, or blockquote is not an invocation: a cheapmention-filterjob runsdetect-bot-mentionand withholds the agent job (gha#554).claude-code-review.ymlruns a read-only Claude review: a consolidated summary on dispatched runs by default; add apull_requesttrigger in the caller if you also want automatic reviews on PR updates (GitHub suppressespull_requestruns for conflicting PRs; gha#859). The model job’sGITHUB_TOKENhas no write scopes (contents/pull-requests/issues/actions/checks: read); jobs that holdpull-requests: write/issues: writenever invoke the model (gha#580). The caller still grantsactions: read:post-reviewdownloads the packed artifact, and apermissions:block sets unspecified scopes to none. The caller is also asked to grantchecks: read, whichGET .../commits/{ref}/check-runsneeds andactions: readdoes 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 inv3, now that the caller-side grant above is established practice – a caller already granting it moves to@v3at 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, andallowed_botsare forwarded cleanly, withuse_sticky_comment: 'false'hardcoded inrun-claude-review-attemptso 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, andgh 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.ymlis 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.ymlis 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 adest-dir, records the source repo and commit in a JSON manifest, and opens a PR when the copy changes.sync-upstream.ymlis 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.