From 873d698bc8e134b601505838b64af637e7da7507 Mon Sep 17 00:00:00 2001 From: VascoSch92 Date: Thu, 5 Mar 2026 16:30:36 +0100 Subject: [PATCH 1/5] add new field-based features --- sdk/guides/agent-file-based.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/sdk/guides/agent-file-based.mdx b/sdk/guides/agent-file-based.mdx index e96439f0..b3a132a6 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 | `[]` | A list of skill names for this agent, resolved from the project or user directories. This can be provided as a comma-separated string or a YAML list.| +| `max_iteration_per_run`| No | `None`| Maximum iteration per run. It must be strictly positive, or `None`for default | | `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 | ### `` Tags From e14a09e5f42d50686a95b88ea909fe5d4200aae4 Mon Sep 17 00:00:00 2001 From: Vasco Schiavo <115561717+VascoSch92@users.noreply.github.com> Date: Thu, 5 Mar 2026 16:59:32 +0100 Subject: [PATCH 2/5] Update sdk/guides/agent-file-based.mdx Co-authored-by: OpenHands Bot --- sdk/guides/agent-file-based.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sdk/guides/agent-file-based.mdx b/sdk/guides/agent-file-based.mdx index b3a132a6..1031e346 100644 --- a/sdk/guides/agent-file-based.mdx +++ b/sdk/guides/agent-file-based.mdx @@ -51,7 +51,7 @@ The YAML frontmatter configures the agent. The Markdown body becomes the agent's | `tools` | No | `[]` | List of tools the agent can use | | `model` | No | `"inherit"` | LLM model profile to load and use for the subagent (`"inherit"` uses the parent agent's model) | | `skills`| No | `[]` | A list of skill names for this agent, resolved from the project or user directories. This can be provided as a comma-separated string or a YAML list.| -| `max_iteration_per_run`| No | `None`| Maximum iteration per run. It must be strictly positive, or `None`for default | +| `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 | ### `` Tags From f35430cd7fe224ec8221d1dfe4d49475f1519366 Mon Sep 17 00:00:00 2001 From: VascoSch92 Date: Thu, 5 Mar 2026 17:05:38 +0100 Subject: [PATCH 3/5] suggestions --- sdk/guides/agent-file-based.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sdk/guides/agent-file-based.mdx b/sdk/guides/agent-file-based.mdx index 1031e346..738cfc26 100644 --- a/sdk/guides/agent-file-based.mdx +++ b/sdk/guides/agent-file-based.mdx @@ -50,8 +50,8 @@ The YAML frontmatter configures the agent. The Markdown body becomes the agent's | `description` | No | `""` | What this agent does. Shown to the orchestrator | | `tools` | No | `[]` | List of tools the agent can use | | `model` | No | `"inherit"` | LLM model profile to load and use for the subagent (`"inherit"` uses the parent agent's model) | -| `skills`| No | `[]` | A list of skill names for this agent, resolved from the project or user directories. This can be provided as a comma-separated string or a YAML list.| -| `max_iteration_per_run`| No | `None`| Maximum iterations per run. Must be strictly positive, or `None` for the default value. | +| `skills` | No | `[]` | A list of skill names for this agent, resolved from `{project}/.agents/skills/`, `{project}/.openhands/skills/`, `~/.agents/skills/`, or `~/.openhands/skills/` (see [Skill Loading Precedence](/overview/skills#skill-loading-precedence)). Can be a comma-separated string or a YAML list. | +| `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 | ### `` Tags From 28dd2322d8b3fc164dcb09f4d60ec649bd546bd2 Mon Sep 17 00:00:00 2001 From: Vasco Schiavo <115561717+VascoSch92@users.noreply.github.com> Date: Thu, 5 Mar 2026 17:10:33 +0100 Subject: [PATCH 4/5] Update sdk/guides/agent-file-based.mdx Co-authored-by: OpenHands Bot --- sdk/guides/agent-file-based.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sdk/guides/agent-file-based.mdx b/sdk/guides/agent-file-based.mdx index 738cfc26..3a811eb9 100644 --- a/sdk/guides/agent-file-based.mdx +++ b/sdk/guides/agent-file-based.mdx @@ -50,7 +50,7 @@ The YAML frontmatter configures the agent. The Markdown body becomes the agent's | `description` | No | `""` | What this agent does. Shown to the orchestrator | | `tools` | No | `[]` | List of tools the agent can use | | `model` | No | `"inherit"` | LLM model profile to load and use for the subagent (`"inherit"` uses the parent agent's model) | -| `skills` | No | `[]` | A list of skill names for this agent, resolved from `{project}/.agents/skills/`, `{project}/.openhands/skills/`, `~/.agents/skills/`, or `~/.openhands/skills/` (see [Skill Loading Precedence](/overview/skills#skill-loading-precedence)). Can be a comma-separated string or a YAML list. | +| `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 | From 3d25df71fb98705debf050f4144b84f40b23776d Mon Sep 17 00:00:00 2001 From: openhands Date: Thu, 5 Mar 2026 17:58:55 +0000 Subject: [PATCH 5/5] fix(ci): upgrade to Node 22 to fix katex __VERSION__ crash in mint CLI MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The mint CLI >=4.2.404 ships a katex version whose ESM entry point references an unbundled __VERSION__ constant. Node 20 throws 'ReferenceError: __VERSION__ is not defined'; Node 22 handles this correctly. Upgrade the CI from Node 20 → 22 so we can keep using mint@latest. Co-authored-by: openhands --- .github/workflows/check-broken-links.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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