fix(frontend): do not gate the skills modal on runtime readiness

[hieptl]

• A human has tested these changes.

---

Why

Problem

Opening the Available Skills modal from the chat input's + menu on the home page shows a loading spinner with "Waiting for runtime to start…" that never completes. The modal is unusable from the home page on both local and cloud backends, and from any conversation whose execution status is null (e.g. a stopped cloud sandbox).

Steps to Reproduce

1. Start the development server: npm run dev
2. On the home page, click the plus (+) icon in the chat input to open the context menu
3. Select "Show Available Skills"

Current Behavior

The modal opens, but the spinner ("Waiting for runtime to start…") spins indefinitely. No skills are ever listed and no error is shown.

Expected Behavior

• The modal loads and displays the list of available skills
• If the list cannot be loaded, a clear failure message is shown instead of an endless spinner

Root Cause

SkillsModal gates its entire body on isAgentReady, derived from useAgentState(), which maps a null execution status to AgentState.LOADING. With no conversation (home page) — or a conversation whose status stays null — that state never changes, so the waiting branch renders forever.

The gate is vestigial: it dates from when skills were loaded from the conversation runtime (loadSkillsForConversation, enabled: !!executionStatus). Since PR #362 the skills come from a static catalog (SkillsService.getSkills — agent-server SkillsClient locally, /api/v1/skills/search on cloud) that requires no conversation or runtime. The Skills settings page and the slash-command menu already consume the same catalog ungated.

Fix

Remove the runtime-readiness gate from SkillsModal and let the skills query's own states drive the UI (loading → spinner, error → "Failed to fetch skills…", data → grouped catalog). Delete the orphaned SkillsRuntimeWaitingState component.

Acceptance Criteria

• Opening Available Skills from the home page + menu lists the skills catalog
• When the skills fetch fails, the modal shows the fetch-error message instead of hanging
• Works on local and cloud backends, and in conversations regardless of runtime state
• Regression tests cover the home-page and fetch-failure paths

Summary

Fixes the Available Skills modal spinning forever on "Waiting for runtime to start…" when opened from the home page's chat input + menu (reproducible on local and cloud backends), and in any conversation whose execution status is null.

Problem

SkillsModal only rendered its content once curAgentState left LOADING/INIT:

const isAgentReady = ![AgentState.LOADING, AgentState.INIT].includes(curAgentState);
...
{!isAgentReady ? <SkillsRuntimeWaitingState /> : ...}

useAgentState() maps a null execution status to AgentState.LOADING. On the home page no conversation exists, so the status is null forever → the waiting spinner never resolves.

Root Cause

The gate is a leftover from when skills were loaded from the conversation runtime (loadSkillsForConversation, gated on executionStatus). Since #362 the modal reads a static catalog via SkillsService.getSkills() — agent-server SkillsClient locally, /api/v1/skills/search via the cloud proxy on cloud backends — which needs no conversation or runtime. The Skills settings page (useSkills()) and the slash-command menu (useConversationSkills()) already consume the same catalog with no such gate.

Changes

• src/components/features/conversation-panel/skills-modal.tsx — remove the isAgentReady gate; the skills query's own states now drive the UI (isLoading → loading state, isError → "Failed to fetch skills. Please try again later.", data → grouped catalog). One internal change fixes all three render sites (chat + menu, tools menu, conversation-title menu).
• src/components/features/conversation-panel/skills-runtime-waiting-state.tsx — deleted (orphaned; the DIFF_VIEWER$WAITING_FOR_RUNTIME i18n key remains in use by diff-viewer components).
• __tests__/components/modals/skills/skill-modal.test.tsx — remove the useAgentState mock and the test asserting the old gating behavior; add regression tests (mocking SkillsService, not hooks):
  • displays the skills catalog when opened with no active conversation (home page)
  • surfaces the fetch-error message when the catalog cannot be loaded

Deliberately not added: an enabled: !!conversation.data gate on the skills query — that would reintroduce the hang on the home page.

Issue Number

Resolves #2092

How to Test

1. Start the development server: npm run dev
2. On the home page, click the plus (+) icon in the chat input to open the context menu
3. Select "Show Available Skills"

Video/Screenshots

app-2155.mov

Type

• Bug fix
• Feature
• Refactor
• Breaking change
• Docs / chore

---

🐳 Docker images for this PR

• GHCR package: https://github.com/OpenHands/agent-canvas/pkgs/container/agent-canvas

Component	Value
Image	ghcr.io/openhands/agent-canvas
Architectures	amd64, arm64
Agent Server	ghcr.io/openhands/agent-server:1.24.0-python
Automation	openhands-automation==1.0.0a6
Commit	c5d69ae41a0dfda44a712011f04c9652a71da7d4

Pull (multi-arch manifest)

# Multi-arch manifest — Docker automatically pulls the correct architecture
docker pull ghcr.io/openhands/agent-canvas:sha-c5d69ae

Run

docker run -it --rm \
  -p 8000:8000 \
  ghcr.io/openhands/agent-canvas:sha-c5d69ae

All tags pushed for this build

ghcr.io/openhands/agent-canvas:sha-c5d69ae-amd64
ghcr.io/openhands/agent-canvas:hieptl-app-2155-amd64
ghcr.io/openhands/agent-canvas:pr-1122-amd64
ghcr.io/openhands/agent-canvas:sha-c5d69ae-arm64
ghcr.io/openhands/agent-canvas:hieptl-app-2155-arm64
ghcr.io/openhands/agent-canvas:pr-1122-arm64
ghcr.io/openhands/agent-canvas:sha-c5d69ae
ghcr.io/openhands/agent-canvas:hieptl-app-2155
ghcr.io/openhands/agent-canvas:pr-1122

About Multi-Architecture Support

• Each tag (e.g., sha-c5d69ae) is a multi-arch manifest supporting both amd64 and arm64
• Docker automatically pulls the correct architecture for your platform
• Individual architecture tags (e.g., sha-c5d69ae-amd64) are also available if needed

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agent-canvas	Ready	Preview, Comment	Jun 4, 2026 2:33pm

[tofarr]

🍰

[openhands-release-bot]

🚀 Released in v1.2.0.

[github-actions]

📸 Snapshot Test Report

Warning

Snapshot comparison step crashed (timeout, OOM, or runner error) — diff results below may be incomplete or absent.
Check the CI logs for the full error output (look for the "Run snapshot comparison" step).

✅ No baseline found on main — all 73 snapshots are new and will become the baseline once this PR merges.

Category	Count
🔴 Changed	0
🆕 New	73
✅ Unchanged	0
Total	73

🆕 New snapshots (73)

These snapshots have no baseline on main and will become the new baseline once this PR merges.

archived-conversation — 3 snapshots

conversation-panel-with-archived-badges

conversation-view-archived

conversation-view-sandbox-error

automations — 4 snapshots

automations-delete-modal

automations-list-active-inactive

automations-no-automations

automations-search-no-results

backends-extended — 19 snapshots

backend-add-blank-disabled

backend-add-cloud-advanced-open

backend-add-cloud-no-key-disabled

backend-add-cloud-with-key-enabled

backend-add-form-partially-filled

backend-add-invalid-url-disabled

backend-add-local-ready

backend-add-name-only-disabled

backend-add-two-column-layout

backend-add-whitespace-host-disabled

backend-after-switch

backend-cancel-nothing-saved

backend-dropdown-two-backends

backend-edit-prefilled

backend-manage-after-removal

backend-manage-two-listed

backend-remove-cancelled

backend-remove-confirmation

backend-switch-overlay

backends — 3 snapshots

backend-add-modal

backend-manage-modal

backend-selector-open

changes-tab — 3 snapshots

changes-deleted-file

changes-diff-viewer

changes-empty

collapsible-thinking — 4 snapshots

reasoning-content-collapsed

reasoning-content-expanded

think-action-collapsed

think-action-expanded

mcp-page — 11 snapshots

mcp-custom-server-1-editor-open

mcp-custom-server-2-url-filled

mcp-custom-server-3-all-filled

mcp-custom-server-4-installed

mcp-custom-server-editor

mcp-empty-installed

mcp-search-filtered

mcp-slack-install-1-marketplace

mcp-slack-install-2-modal

mcp-slack-install-3-filled

mcp-slack-install-4-installed

onboarding — 4 snapshots

onboarding-step-0-check-backend

onboarding-step-1-choose-agent

onboarding-step-2-setup-llm

onboarding-step-3-say-hello

projects-workspace-browser

projects-workspace-browser

settings-page — 5 snapshots

add-backend-modal

analytics-consent-modal

home-screen

settings-app-page

settings-page

settings-secrets — 5 snapshots

secrets-add-form-filled

secrets-add-form

secrets-after-save

secrets-delete-confirm

secrets-list

settings-verification — 3 snapshots

condenser-settings

verification-settings-off

verification-settings-on

sidebar — 3 snapshots

sidebar-collapsed

sidebar-conversation-panel

sidebar-filter-menu

skills-page — 5 snapshots

skills-empty

skills-loaded

skills-no-match

skills-search-filtered

skills-type-filter

---

Generated by the Snapshot Tests workflow. This comment was created by an AI agent (OpenHands) on behalf of the repo maintainers.