feat: add user-configurable enable/disable of default global skills w… by statxc · Pull Request #13046 · OpenHands/OpenHands

statxc · 2026-02-25T15:04:36Z

Summary of PR

Users have no way to turn off default global skills today - everything loads automatically. The disabled_microagents field already existed in AgentConfig but nothing in the UI or API ever used it.

This PR wires it up end-to-end:

Settings model now stores disabled_microagents, persisted per user
That list gets threaded through session startup into Memory, which skips disabled skills when building repo instructions, matching knowledge triggers, and loading MCP tools
New GET /api/skills endpoint so the frontend knows what skills exist
New Skills page under Settings with toggles for each skill
Works through both web and CLI paths

27 files changed: mostly plumbing through existing layers, the usual frontend boilerplate (types, hook, route, i18n, page component), and enterprise DB schema. Tests cover Memory filtering, the API endpoint, and settings persistence

Issue: #13034

Change Type

…ith settings persistence, API endpoint, and frontend UI

…feat/skill-disable-core

…, and single source of truth

statxc · 2026-02-25T16:39:23Z

@enyst would be really thankful to give me any feedback!

enyst

Thank you for the PR!

May I ask what LLM and what agent are you using?

Also, I’d love to know the prompt(s).

I think this isn’t quite right: the PR code makes changes to V0 too, and it shouldn’t, it’s a legacy version we will remove soon. It also uses the old “microagents” term which we have changed to Skills.

Edited to add: we always appreciate proofs that a PR works for you. Screenshots, videos in case maybe.

statxc · 2026-02-25T16:49:48Z

Ok. I will revert changes legacy version V0.
I will attach screenshot

…d_skills, fix mypy backslash-in-fstring errors

statxc · 2026-02-25T19:13:24Z

test.webm

@enyst could you please review the pr again? Thanks!

statxc · 2026-02-27T18:51:38Z

@enyst any update for me?

enyst · 2026-02-28T17:20:21Z

+from pydantic import BaseModel
+
+from openhands.core.logger import openhands_logger as logger
+from openhands.memory.memory import GLOBAL_MICROAGENTS_DIR, USER_MICROAGENTS_DIR


I think code here, including this, has a lot of legacy V0 😢

enyst · 2026-02-28T17:21:02Z

        if len(splited_commands) > 1:
+            cmd_list = '\n'.join(
+                f'({i + 1}) {cmd}' for i, cmd in enumerate(splited_commands)
+            )


I think this file is legacy V0, your agent just went ahead for some reason

enyst · 2026-02-28T17:21:12Z

                splited_cmds = [
                    str(s.Extent.Text) for s in statements
                ]  # Try to get text
+                cmd_list = '\n'.join(


Same here, not in use

enyst · 2026-02-28T18:43:42Z

+
+class SkillsService {
+  /**
+   * Get the list of available skills (global + user microagents)


The fact that the LLM says "user microagents" (V0) seems to me a bit of a warning flag. Unfortunately, we have some chaos in this codebase, with the legacy version + the current version + a bunch of things on top

It's maybe not so "agent ready" as we may want it to be 😓 Sorry about that

enyst · 2026-02-28T18:54:56Z

If I may suggest, @statxc , maybe try to focus on issues labeled good-first-issue, or please note: this functionality is discussed in multiple issues across V1 agent (software-agent-sdk repository), CLI repo, and this repo, which is actually the Web application repo. Please feel free to participate to discussions and let's figure out what we want.

On this PR, I like the video, it makes sense, maybe that's how we want it on the web! I think we should show it to people working on the web interface. Could you maybe join Slack and propose it in #proj-gui channel?

On another note, I'm still curious: what LLM, what agent, and what prompts you used? 😅 It's becoming the more important and fun stuff these days.

…feat/skill-disable-core

statxc · 2026-03-02T01:18:25Z

@enyst Sorry for the inconvenience. I’ve updated it again based on your feedback. thanks a lot. 🙏

I also reviewed the legacy V0 on my hand and re-tested everything, and I confirmed it’s working properly. Could you please review and test it again?

About the LLM agent: I’m using Claude Opus 4.6, but I always review the changes and test them myself. I only submit a PR after I’ve confirmed all tests pass. 😊

statxc · 2026-03-06T00:14:51Z

@enyst please any update for me. Hope to merge this pr if it has no problem.

statxc · 2026-03-18T00:11:13Z

@enyst Updated! Testing errors don't seem to relate to my changes.

…k endpoint

statxc · 2026-03-24T13:01:35Z

@enyst Sorry to bother you. What else should I need to update more? I submitted this PR a month ago. I want to wrap up this PR. Thanks

enyst

Looks good to me now, thank you!

cc: @tofarr @hieptl This PR contains enterprise migrations. I will defer to you for the rest of the PR process.

The PR was cleaned up from v0 and issues, thank you!

tofarr · 2026-03-24T15:52:44Z

@@ -0,0 +1,28 @@
+"""add disabled_skills to user_settings


There have been other migrations since this - I think the number will need to be 102 to prevent collisions

…feat/skill-disable-core

tofarr · 2026-03-24T16:05:51Z

+    '',
+    response_model=SkillListResponse,
+)
+async def list_skills() -> SkillListResponse:


In our API we have generally steered away from having list methods - all endpoints are designed with pagination in mind up front. Even if it is not likely that there will be a prohibitive number of skills it maintains consistency - the first question is always "What if there are 10,000 of them?" We can change the internal structure more easily to accommodate large numbers but once we have exposed an unpaginated API endpoint is is much harder to put that toothpaste back in the tube.

see: https://github.com/search?q=repo%3AOpenHands%2FOpenHands+search_+path%3A*_router.py&type=code

search implies we are searching - list implies we get them all.

search methods return a page object with a next_page_id and items

tofarr

Great work! I have a few small changes to request on the backend and will look into the frontend now.

statxc · 2026-03-24T16:33:19Z

@tofarr Could you please review again? I updated backend following your feedback

tofarr · 2026-03-24T20:17:42Z

Backend looks really good!
I have a few requests for the frontend code:

Please remove the second Skills header
Please move the description Enable or disable default skills. Disabled skills will not be loaded into agent context. outside the scroll div below the first Skills header.
Please make sure that skills handle special characters correctly. e.g.: Triggers: /add_repo_inst global / knowledge should be Triggers: /add_repo_inst global / knowledge

…feat/skill-disable-core

tofarr

Great work here! Thank you!

feat: add user-configurable enable/disable of default global skills w…

da7038f

…ith settings persistence, API endpoint, and frontend UI

statxc requested review from amanape, hieptl, malhotra5 and tofarr as code owners February 25, 2026 15:04

intelliking added 3 commits February 25, 2026 15:06

Merge branch 'main' of https://github.com/intelliking/OpenHands into …

72fe0e5

…feat/skill-disable-core

fix bugs in skill disable feature - settings merge, V1 path filtering…

2d02928

…, and single source of truth

fix: testing error

c463beb

statxc requested a review from chuckbutkus as a code owner February 25, 2026 16:23

intelliking added 2 commits February 25, 2026 16:26

Merge remote-tracking branch 'origin/main' into feat/skill-disable-core

3f270af

fix: add i18n translation

3b4c41d

enyst previously requested changes Feb 25, 2026

View reviewed changes

intelliking added 2 commits February 25, 2026 17:41

fix: revert V0 legacy changes, rename disabled_microagents to disable…

d821f05

…d_skills, fix mypy backslash-in-fstring errors

fix: recover skill router

50cbfb6

solve merge conflict

fe8a4a1

enyst reviewed Feb 28, 2026

View reviewed changes

statxc added 3 commits March 2, 2026 01:00

fix: Update legacy V0 version

636e6f8

Merge branch 'main' of https://github.com/intelliking/OpenHands into …

8a095d8

…feat/skill-disable-core

fix: apply ruff-format to skills.py

02d79a9

fix: resolve merge conflict in test_live_status_app_conversation_service

86c6ec1

statxc requested a review from enyst March 18, 2026 00:17

statxc added 2 commits March 19, 2026 17:35

fix: solve conflicts

0131808

fix: solve lint error

7e0fdfc

statxc force-pushed the feat/skill-disable-core branch from 01f71d7 to 7e0fdfc Compare March 19, 2026 18:06

statxc added 4 commits March 19, 2026 18:19

update

95b93be

fix

14cfe42

Fix flaky websocket test by mocking the pending-messages REST fallbac…

d0645de

…k endpoint

fix conflicts

b8a33c7

enyst reviewed Mar 24, 2026

View reviewed changes

tofarr reviewed Mar 24, 2026

View reviewed changes

Merge branch 'main' of https://github.com/intelliking/OpenHands into …

497f99c

…feat/skill-disable-core

tofarr reviewed Mar 24, 2026

View reviewed changes

Comment thread openhands/app_server/user/skills_router.py

update migration version and add error log

74a4fbc

tofarr reviewed Mar 24, 2026

View reviewed changes

tofarr requested changes Mar 24, 2026

View reviewed changes

statxc added 2 commits March 24, 2026 16:18

feat: Add paginated skills search endpoint

7270a97

fix: lint error

d5f62a9

statxc added 4 commits March 24, 2026 20:33

Merge branch 'main' of https://github.com/intelliking/OpenHands into …

7a1b590

…feat/skill-disable-core

fix: update mini frontend error

fb5c8b0

fix lint error

b3bcc74

fix conflicts

efa2679

tofarr approved these changes Mar 24, 2026

View reviewed changes

tofarr merged commit c9b2ce2 into OpenHands:main Mar 24, 2026
22 of 23 checks passed

statxc deleted the feat/skill-disable-core branch March 24, 2026 20:51

mamoodi added the release:cloud-1.19.0 Included in release 1.19.0 label Mar 30, 2026 — with OpenHands AI

Conversation

statxc commented Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary of PR

Issue: #13034

Change Type

Uh oh!

statxc commented Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

enyst left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

statxc commented Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

statxc commented Feb 25, 2026

Uh oh!

statxc commented Feb 27, 2026

Uh oh!

enyst Feb 28, 2026

Choose a reason for hiding this comment

Uh oh!

enyst Feb 28, 2026

Choose a reason for hiding this comment

Uh oh!

enyst Feb 28, 2026

Choose a reason for hiding this comment

Uh oh!

enyst Feb 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

enyst commented Feb 28, 2026

Uh oh!

statxc commented Mar 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

statxc commented Mar 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

statxc commented Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

statxc commented Mar 24, 2026

Uh oh!

enyst left a comment

Choose a reason for hiding this comment

Uh oh!

tofarr Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

tofarr Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

tofarr left a comment

Choose a reason for hiding this comment

Uh oh!

statxc commented Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tofarr commented Mar 24, 2026

Uh oh!

tofarr left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

statxc commented Feb 25, 2026 •

edited

Loading

statxc commented Feb 25, 2026 •

edited

Loading

enyst left a comment •

edited

Loading

statxc commented Feb 25, 2026 •

edited

Loading

enyst Feb 28, 2026 •

edited

Loading

statxc commented Mar 2, 2026 •

edited

Loading

statxc commented Mar 6, 2026 •

edited

Loading

statxc commented Mar 18, 2026 •

edited

Loading

statxc commented Mar 24, 2026 •

edited

Loading