From 21e169dde12a43f6bbdbed37c2e31bb5ce58b9a3 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Tue, 9 Jun 2026 00:13:28 +0000
Subject: [PATCH] [docs] Document `disable-model-invocation` in frontmatter
 reference
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Issue #36275 asked the frontmatter reference page to cover three
top-level fields (`check-for-updates`, `disable-model-invocation`,
`run-install-scripts`) so the in-schema anchor links resolve. Two were
added but `disable-model-invocation` was left undocumented in
`docs/src/content/docs/reference/frontmatter.md` — it only appeared in
the auto-generated `frontmatter-full.md` dump. This adds a curated
section so users browsing the reference can see what the field does.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 docs/src/content/docs/reference/frontmatter.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/src/content/docs/reference/frontmatter.md b/docs/src/content/docs/reference/frontmatter.md
index d2140cef6a0..ba9a37c1b93 100644
--- a/docs/src/content/docs/reference/frontmatter.md
+++ b/docs/src/content/docs/reference/frontmatter.md
@@ -467,6 +467,16 @@ check-for-updates: true
 
 When `true` (default), the activation job verifies the compiled version is not blocked and meets the minimum supported version. Set to `false` to disable this check (not allowed in strict mode).
 
+### `disable-model-invocation`
+
+Controls whether the custom agent file produced by the workflow can be auto-invoked by a host model. When set to `true`, downstream tooling treats the agent as documentation-only and will not call into it.
+
+```yaml wrap
+disable-model-invocation: true
+```
+
+Use this on skill or sub-agent files that should be loaded as reference material rather than executed (for example, `.github/aw/*.md` skill files). The `gh aw fix --write` codemod `infer-to-disable-model-invocation` migrates the deprecated `infer:` field to this one, inverting the boolean.
+
 ### Feature Flags (`features:`)
 
 Enable experimental or optional compiler and runtime behaviors as key-value pairs. See [Feature Flags](/gh-aw/reference/feature-flags/) for complete documentation.