starred/orca
1
0
Fork 0
mirror of https://github.com/stablyai/orca.git synced 2026-10-02 08:02:02 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix(skills): name browser page automation surfaces

Browse Source
This commit is contained in:
Jinwoo-H
2026-08-31 18:37:07 -04:00
parent 7fa5198255
commit bf8d06a0ae
13 changed files with 69 additions and 63 deletions
Download Patch File Download Diff File Expand all files Collapse all files
config/scripts/computer-use-skill-guidance.test.mjs
+4
View File
@@ -20,6 +20,10 @@ describe('computer-use skill guidance', () => {
expect(description).toContain('external browser window')
expect(description).toContain("Do not use for Orca's embedded browser")
expect(description).toContain('page-only browser automation')
expect(description).toContain("`orca-cli` for Orca's embedded pages")
expect(description).toContain(
'page-automation tool such as Playwright or CDP for external pages'
)
expect(description).not.toContain('read Slack')
expect(description).not.toContain('get app state')
config/scripts/orca-cli-skill-guidance.test.mjs
+2 -2
View File
@@ -26,13 +26,13 @@ describe('orca CLI skill guidance', () => {
'Use Computer Use for external browser windows, webviews, or desktop UI only when the task requires OS/window-level control such as focus, menus, dialogs, coordinates, or screenshots.'
)
expect(description).toContain(
'Use a browser/page skill for DOM, content, form, console, network, or Playwright automation.'
"`orca-cli` for Orca's embedded pages and a page-automation tool such as Playwright or CDP for external pages."
)
expect(skill).toContain(
'For external Chrome/Safari/webviews or Orca app chrome/settings, use the Computer Use skill/tool only when the task requires OS/window-level control'
)
expect(skill).toContain(
'use a browser/page skill for DOM, content, form, console, network, or Playwright automation'
"Use `orca-cli` for Orca's embedded pages and a page-automation tool such as Playwright or CDP for external pages"
)
})
config/scripts/orchestration-skill-guidance.test.mjs
+1 -1
View File
@@ -32,7 +32,7 @@ describe('orchestration skill guidance', () => {
"Use Computer Use for external browser windows, webviews, Orca app UI, or desktop UI outside Orca's embedded browser only when the task requires OS/window-level control such as focus, menus, dialogs, coordinates, or screenshots."
)
expect(description).toContain(
'Use a browser/page skill for DOM, content, form, console, network, or Playwright automation.'
"`orca-cli` for Orca's embedded pages and a page-automation tool such as Playwright or CDP for external pages."
)
})
resources/skills/current-manifest.json
+18 -18
View File
@@ -5,17 +5,17 @@
"name": "computer-use",
"sourcePath": "skills/computer-use",
"releaseRevision": 9,
"packageDigest": "a1a0350181211561073f9c2b91e34fd83585b3a8e81d95fc1459bbd665c24eff",
"gitTreeSha": "3751b5a3d4b5b31dfd753e807e486d2f82628214",
"packageDigest": "ddc9f910985ae67ab693263026d99c68dc34b6f0c12b444b620cd0e19c3df36a",
"gitTreeSha": "f0561c41d1f709a953684aef5d5368f8c58d269f",
"files": [
{
"path": "SKILL.md",
"size": 3331,
"size": 3465,
"executable": false,
"classification": "text",
"exactSha256": "c75e057b1c41e0c48f2c0d159d9fa75a9951d0c4bc32ba8bbd59e42ef559f3de",
"textNormalizedSha256": "c75e057b1c41e0c48f2c0d159d9fa75a9951d0c4bc32ba8bbd59e42ef559f3de",
"identitySha256": "c75e057b1c41e0c48f2c0d159d9fa75a9951d0c4bc32ba8bbd59e42ef559f3de"
"exactSha256": "a3fcca06875e354a470e7daef5619172a3615fbbf82900ff3e0a65636fc694c6",
"textNormalizedSha256": "a3fcca06875e354a470e7daef5619172a3615fbbf82900ff3e0a65636fc694c6",
"identitySha256": "a3fcca06875e354a470e7daef5619172a3615fbbf82900ff3e0a65636fc694c6"
}
]
},
@@ -41,17 +41,17 @@
"name": "orca-cli",
"sourcePath": "skills/orca-cli",
"releaseRevision": 37,
"packageDigest": "017f6179b4b1b7dee6591fa307244f7709624285d34f476a12c1fb21b69ddf11",
"gitTreeSha": "954f419a06db0de4281ea52206bf0347963582f2",
"packageDigest": "d1b830256e3fda11408320631722e07bb4bbadf99d19c94f1e00f73b7bc8462d",
"gitTreeSha": "cdf89459f89dddf347ee2759ff884c369051f06a",
"files": [
{
"path": "SKILL.md",
"size": 4129,
"size": 4150,
"executable": false,
"classification": "text",
"exactSha256": "309376bc6c2a1553bdfc8b195f9b8257a7d5623358b242ddeb3cf82d499cd0b3",
"textNormalizedSha256": "309376bc6c2a1553bdfc8b195f9b8257a7d5623358b242ddeb3cf82d499cd0b3",
"identitySha256": "309376bc6c2a1553bdfc8b195f9b8257a7d5623358b242ddeb3cf82d499cd0b3"
"exactSha256": "6dcbd69045c74787be3385198750c67223709c5fa63a2ba3cfbbe0403e1219f5",
"textNormalizedSha256": "6dcbd69045c74787be3385198750c67223709c5fa63a2ba3cfbbe0403e1219f5",
"identitySha256": "6dcbd69045c74787be3385198750c67223709c5fa63a2ba3cfbbe0403e1219f5"
}
]
},
@@ -131,17 +131,17 @@
"name": "orchestration",
"sourcePath": "skills/orchestration",
"releaseRevision": 29,
"packageDigest": "f72c6c9bf1244ec4959cf2602e59387456a5030396c98fa45c81e23de4129006",
"gitTreeSha": "ccaff97151cc2eb9db4517b837c09504268aea58",
"packageDigest": "7a386ce558ba54abe02b4a0de5d71fe3d63c944ef0888ddde130c729b37f7cc8",
"gitTreeSha": "4199ec6988801dd491631706cba62631b4bed8fb",
"files": [
{
"path": "SKILL.md",
"size": 4430,
"size": 4451,
"executable": false,
"classification": "text",
"exactSha256": "f34d9fa486a54532b9630869c0eb6ea9f79251d04a3f80613a00e6cf05d17a01",
"textNormalizedSha256": "f34d9fa486a54532b9630869c0eb6ea9f79251d04a3f80613a00e6cf05d17a01",
"identitySha256": "f34d9fa486a54532b9630869c0eb6ea9f79251d04a3f80613a00e6cf05d17a01"
"exactSha256": "a7e3350f037698ebbce36b2818d8383ec6e96c2a4825537caab39a83b4fb4b7f",
"textNormalizedSha256": "a7e3350f037698ebbce36b2818d8383ec6e96c2a4825537caab39a83b4fb4b7f",
"identitySha256": "a7e3350f037698ebbce36b2818d8383ec6e96c2a4825537caab39a83b4fb4b7f"
}
]
}
resources/skills/snapshot-registry.json
+18 -18
View File
@@ -580,17 +580,17 @@
},
{
"releaseRevision": 37,
"packageDigest": "017f6179b4b1b7dee6591fa307244f7709624285d34f476a12c1fb21b69ddf11",
"gitTreeSha": "954f419a06db0de4281ea52206bf0347963582f2",
"packageDigest": "d1b830256e3fda11408320631722e07bb4bbadf99d19c94f1e00f73b7bc8462d",
"gitTreeSha": "cdf89459f89dddf347ee2759ff884c369051f06a",
"files": [
{
"path": "SKILL.md",
"size": 4129,
"size": 4150,
"executable": false,
"classification": "text",
"exactSha256": "309376bc6c2a1553bdfc8b195f9b8257a7d5623358b242ddeb3cf82d499cd0b3",
"textNormalizedSha256": "309376bc6c2a1553bdfc8b195f9b8257a7d5623358b242ddeb3cf82d499cd0b3",
"identitySha256": "309376bc6c2a1553bdfc8b195f9b8257a7d5623358b242ddeb3cf82d499cd0b3"
"exactSha256": "6dcbd69045c74787be3385198750c67223709c5fa63a2ba3cfbbe0403e1219f5",
"textNormalizedSha256": "6dcbd69045c74787be3385198750c67223709c5fa63a2ba3cfbbe0403e1219f5",
"identitySha256": "6dcbd69045c74787be3385198750c67223709c5fa63a2ba3cfbbe0403e1219f5"
}
]
}
@@ -1046,17 +1046,17 @@
},
{
"releaseRevision": 29,
"packageDigest": "f72c6c9bf1244ec4959cf2602e59387456a5030396c98fa45c81e23de4129006",
"gitTreeSha": "ccaff97151cc2eb9db4517b837c09504268aea58",
"packageDigest": "7a386ce558ba54abe02b4a0de5d71fe3d63c944ef0888ddde130c729b37f7cc8",
"gitTreeSha": "4199ec6988801dd491631706cba62631b4bed8fb",
"files": [
{
"path": "SKILL.md",
"size": 4430,
"size": 4451,
"executable": false,
"classification": "text",
"exactSha256": "f34d9fa486a54532b9630869c0eb6ea9f79251d04a3f80613a00e6cf05d17a01",
"textNormalizedSha256": "f34d9fa486a54532b9630869c0eb6ea9f79251d04a3f80613a00e6cf05d17a01",
"identitySha256": "f34d9fa486a54532b9630869c0eb6ea9f79251d04a3f80613a00e6cf05d17a01"
"exactSha256": "a7e3350f037698ebbce36b2818d8383ec6e96c2a4825537caab39a83b4fb4b7f",
"textNormalizedSha256": "a7e3350f037698ebbce36b2818d8383ec6e96c2a4825537caab39a83b4fb4b7f",
"identitySha256": "a7e3350f037698ebbce36b2818d8383ec6e96c2a4825537caab39a83b4fb4b7f"
}
]
}
@@ -1210,17 +1210,17 @@
},
{
"releaseRevision": 9,
"packageDigest": "a1a0350181211561073f9c2b91e34fd83585b3a8e81d95fc1459bbd665c24eff",
"gitTreeSha": "3751b5a3d4b5b31dfd753e807e486d2f82628214",
"packageDigest": "ddc9f910985ae67ab693263026d99c68dc34b6f0c12b444b620cd0e19c3df36a",
"gitTreeSha": "f0561c41d1f709a953684aef5d5368f8c58d269f",
"files": [
{
"path": "SKILL.md",
"size": 3331,
"size": 3465,
"executable": false,
"classification": "text",
"exactSha256": "c75e057b1c41e0c48f2c0d159d9fa75a9951d0c4bc32ba8bbd59e42ef559f3de",
"textNormalizedSha256": "c75e057b1c41e0c48f2c0d159d9fa75a9951d0c4bc32ba8bbd59e42ef559f3de",
"identitySha256": "c75e057b1c41e0c48f2c0d159d9fa75a9951d0c4bc32ba8bbd59e42ef559f3de"
"exactSha256": "a3fcca06875e354a470e7daef5619172a3615fbbf82900ff3e0a65636fc694c6",
"textNormalizedSha256": "a3fcca06875e354a470e7daef5619172a3615fbbf82900ff3e0a65636fc694c6",
"identitySha256": "a3fcca06875e354a470e7daef5619172a3615fbbf82900ff3e0a65636fc694c6"
}
]
}
skill-guides/computer-use.md
+3 -3
View File
@@ -5,13 +5,13 @@ description: >-
local app windows. Use when a task must read or operate a native app or an
external browser window (for example, Chrome, Edge, or Safari) or an app
webview. Do not use for Orca's embedded browser or page-only browser
automation; use the Orca CLI or
a browser/page skill for those surfaces.
automation. Use `orca-cli` for Orca's embedded pages and a page-automation
tool such as Playwright or CDP for external pages.
---
# Computer Use
Use this skill for desktop UI through `orca computer`. For a website or web app, use it only when the page is in an external desktop browser window that needs desktop-level control; use the Orca CLI for its embedded browser and a browser/page skill for page-only automation.
Use this skill for desktop UI through `orca computer`. For a website or web app, use it only when the page is in an external desktop browser window that needs desktop-level control. Do not use it for page-only automation: use `orca-cli` for Orca's embedded pages and a page-automation tool such as Playwright or CDP for external pages.
## Preconditions
skill-guides/orca-cli.md
+3 -3
View File
@@ -12,8 +12,8 @@ description: >-
PTYs, Playwright, or Computer Use when the task touches Orca-managed state.
Use Computer Use for external browser windows, webviews, or desktop UI only
when the task requires OS/window-level control such as focus, menus, dialogs,
coordinates, or screenshots. Use a browser/page skill for DOM, content, form,
console, network, or Playwright automation.
coordinates, or screenshots. Use `orca-cli` for Orca's embedded pages and a
page-automation tool such as Playwright or CDP for external pages.
---
# Orca CLI
@@ -311,7 +311,7 @@ ORCA skills share --skill <selector> [--skill <selector> ...] --bundle-name <nam
The built-in browser is Orca's embedded browser tab surface, scoped to Orca worktrees; it is not Chrome/Safari or desktop app UI.
These commands control only Orca's embedded browser tabs. For external Chrome/Safari/webviews or Orca app chrome/settings, use the Computer Use skill/tool only when the task requires OS/window-level control; use a browser/page skill for DOM, content, form, console, network, or Playwright automation. If the user explicitly asks for Orca CLI desktop control, use `orca computer ...`; do not use browser commands for desktop UI.
These commands control only Orca's embedded browser tabs. For external Chrome/Safari/webviews or Orca app chrome/settings, use the Computer Use skill/tool only when the task requires OS/window-level control. Use `orca-cli` for Orca's embedded pages and a page-automation tool such as Playwright or CDP for external pages. If the user explicitly asks for Orca CLI desktop control, use `orca computer ...`; do not use browser commands for desktop UI.
Use a snapshot-interact-re-snapshot loop:
skill-guides/orchestration.md
+2 -2
View File
@@ -13,8 +13,8 @@ description: >-
browser embedded inside Orca. Use Computer Use for external browser windows,
webviews, Orca app UI, or desktop UI outside Orca's embedded browser only when
the task requires OS/window-level control such as focus, menus, dialogs,
coordinates, or screenshots. Use a browser/page skill for DOM, content, form,
console, network, or Playwright automation.
coordinates, or screenshots. Use `orca-cli` for Orca's embedded pages and a
page-automation tool such as Playwright or CDP for external pages.
---
# Orca Inter-Agent Orchestration
skill-stubs/computer-use.md
+3 -2
View File
@@ -5,8 +5,9 @@ reference is served by the `orca` binary itself — kept out of this file on pur
never drift from the binary that will actually run your commands.
Engage Orca's computer-use surface when a task requires desktop-level access to a visible local
app or window, including a native app or an external browser window/webview. Orca's embedded
browser and page-only browser automation belong to the Orca CLI or a browser/page skill.
app or window, including a native app or an external browser window/webview. Do not use for
Orca's embedded browser or page-only browser automation. Use `orca-cli` for Orca's embedded
pages and a page-automation tool such as Playwright or CDP for external pages.
## Resolve the CLI for this session
skills/computer-use/SKILL.md
+5 -4
View File
@@ -5,8 +5,8 @@ description: >-
local app windows. Use when a task must read or operate a native app or an
external browser window (for example, Chrome, Edge, or Safari) or an app
webview. Do not use for Orca's embedded browser or page-only browser
automation; use the Orca CLI or
a browser/page skill for those surfaces.
automation. Use `orca-cli` for Orca's embedded pages and a page-automation
tool such as Playwright or CDP for external pages.
---
# Computer Use
@@ -16,8 +16,9 @@ reference is served by the `orca` binary itself — kept out of this file on pur
never drift from the binary that will actually run your commands.
Engage Orca's computer-use surface when a task requires desktop-level access to a visible local
app or window, including a native app or an external browser window/webview. Orca's embedded
browser and page-only browser automation belong to the Orca CLI or a browser/page skill.
app or window, including a native app or an external browser window/webview. Do not use for
Orca's embedded browser or page-only browser automation. Use `orca-cli` for Orca's embedded
pages and a page-automation tool such as Playwright or CDP for external pages.
## Resolve the CLI for this session
skills/orca-cli/SKILL.md
+2 -2
View File
@@ -12,8 +12,8 @@ description: >-
PTYs, Playwright, or Computer Use when the task touches Orca-managed state.
Use Computer Use for external browser windows, webviews, or desktop UI only
when the task requires OS/window-level control such as focus, menus, dialogs,
coordinates, or screenshots. Use a browser/page skill for DOM, content, form,
console, network, or Playwright automation.
coordinates, or screenshots. Use `orca-cli` for Orca's embedded pages and a
page-automation tool such as Playwright or CDP for external pages.
---
# Orca CLI
skills/orchestration/SKILL.md
+2 -2
View File
@@ -13,8 +13,8 @@ description: >-
browser embedded inside Orca. Use Computer Use for external browser windows,
webviews, Orca app UI, or desktop UI outside Orca's embedded browser only when
the task requires OS/window-level control such as focus, menus, dialogs,
coordinates, or screenshots. Use a browser/page skill for DOM, content, form,
console, network, or Playwright automation.
coordinates, or screenshots. Use `orca-cli` for Orca's embedded pages and a
page-automation tool such as Playwright or CDP for external pages.
---
# Orca Orchestration
src/cli/bundled-skill-guides.ts
+6 -6
View File
File diff suppressed because one or more lines are too long