diff --git a/.github/workflows/check-broken-links.yml b/.github/workflows/check-broken-links.yml
index eace0f3a..ec78ef11 100644
--- a/.github/workflows/check-broken-links.yml
+++ b/.github/workflows/check-broken-links.yml
@@ -34,7 +34,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '22'
 
       - name: Install Mint CLI
         run: npm install -g mint@latest
diff --git a/sdk/guides/agent-file-based.mdx b/sdk/guides/agent-file-based.mdx
index e96439f0..3a811eb9 100644
--- a/sdk/guides/agent-file-based.mdx
+++ b/sdk/guides/agent-file-based.mdx
@@ -49,7 +49,9 @@ The YAML frontmatter configures the agent. The Markdown body becomes the agent's
 | `name` | Yes | - | Agent identifier (e.g., `code-reviewer`) |
 | `description` | No | `""` | What this agent does. Shown to the orchestrator |
 | `tools` | No | `[]` | List of tools the agent can use |
-| `model` | No | `"inherit"` | LLM model (`"inherit"` uses the parent agent's model) |
+| `model` | No | `"inherit"` | LLM model profile to load and use for the subagent (`"inherit"` uses the parent agent's model) |
+| `skills` | No | `[]` | List of skill names for this agent (see [Skill Loading Precedence](/overview/skills#skill-loading-precedence) for resolution order). |
+| `max_iteration_per_run` | No | `None`| Maximum iterations per run. Must be strictly positive, or `None` for the default value. |
 | `color` | No | `None` | [Rich color name](https://rich.readthedocs.io/en/stable/appendix/colors.html) (e.g., `"blue"`, `"green"`) used by visualizers to style this agent's output in terminal panels |
 
 ### `<example>` Tags