Orkas is an open-source (MIT), local-first AI team for your desktop: a Commander turns your goal into to-dos and coordinates 16 built-in specialist agents plus Claude Code, Codex, OpenCode, OpenClaw and Hermes, with projects, scheduled automations and connectors. Free app for macOS & Windows; built-in models or your own keys.
JavaScript agent-collaborationagent-harnessagent-orchestrationagent-teamagent-workflowai-assistantai-automationai-employeeai-productivityai-teamai-workflowautonomous-agentsclaude-code-guiclaude-coworkdesktop-agentlocal-firstmulti-agentmulti-agent-systemself-evolving-agentstask-automation
Keep UI verification guidance with its implementation reference
wyt4eaed2b55190
diff --git a/resources/builtin/marketplace/skills/fc125b9df078/SKILL.md b/resources/builtin/marketplace/skills/fc125b9df078/SKILL.mdindex f3e2e07a..8b016189 100644--- a/resources/builtin/marketplace/skills/fc125b9df078/SKILL.md+++ b/resources/builtin/marketplace/skills/fc125b9df078/SKILL.md@@ -20,7 +20,7 @@ Do not use this skill to write a PRD, create product test scenarios, split backe| Situation | Read ||---|---|-| Need to build or improve UI in an app | [UI implementation](references/ui-implementation.md) |+| Build or improve UI, including standalone artifacts | [UI implementation](references/ui-implementation.md) || User asks for a known brand/style, DESIGN.md, or "make it look like X" | [Design style index](references/design-style-index.md), then one matching file under `references/design-styles/` || Need a design brief before coding, or the user asks for JSON/Markdown handoff | [UI brief template](references/ui-brief-template.md) |@@ -33,18 +33,10 @@ Read only the relevant style reference. Do not load all design style files at on3. Choose a UI direction: existing product style first; external style reference only when requested or useful.4. Define the screen structure, states, interactions, requested viewport behavior, and accessibility requirements. Add responsive behavior only when the user asks for multi-device or narrow-screen support.5. Implement using the app's existing framework and component patterns.-6. When multiple inspectable source screens define the requested scope, inventory all of them and keep one source-to-target row per screen with must-preserve anchors plus `inspected`, `implemented`, and post-implementation `compared` status. Do not claim all screens complete from shared tokens, a successful build, working routes/links, no overflow, or spot checks. A partial result names every remaining screen; a user fidelity contradiction reopens the full ledger before asking for an example already available in the sources.-7. For runnable local HTML, call `html_preview` on the actual entry before completion. `screenshots` defaults to false for audit-only results; set `screenshots:true` only for the final visual review. Pass `target:"responsive"` only when the user explicitly requests responsive, multi-device, or narrow-screen behavior; otherwise omit target for desktop or use mobile for an explicitly mobile artifact. Source inspection, media-query checks, a local server, PID, or HTTP response do not replace rendered evidence.-8. Summarize what changed, what visual behavior was verified, and any remaining design questions.+6. Follow the implementation reference's verification and handoff procedure before delivery; it owns screen coverage, rendered checks, interaction checks, recovery, and evidence freshness.For a standalone greenfield UI with a clear audience, deliverable, and required sections, the absence of an existing app is not a blocker. Choose the smallest self-contained implementation, use clearly labeled editable sample content when authorized, and produce the complete artifact. Do not replace implementation with a handoff plan merely because no repository, brand system, personal assets, or deployment target was supplied.-For that standalone artifact, finish the whole delivery contract: include every requested section and reachable action, the requested viewport behavior, visible keyboard focus, adequate contrast, accessible labels or alt text, and `prefers-reduced-motion` handling. Add mobile or multi-device reflow only when the user requests it. Requested actions must work with included or inline sample content; do not point a download, image, form, or navigation action at a missing placeholder file. End with copy-paste deployment steps for a suitable static host and an honest checklist covering browser, requested viewport, link, form, and download checks; distinguish checks actually run from checks the recipient must still run. Make the checklist executable by naming every requested viewport (desktop by default), overflow and text-fit inspection, keyboard tab order/focus, link targets, form behavior, and generated download content and filename.--If `html_preview` reports a blocker, inspect its diagnostics; failed checks never return screenshots. Make the smallest runtime/resource/layout repair and rerun the same entry until every requested target succeeds. Do not hide overflow globally, shrink the entire page, or downgrade the result to a source-only check. On the final passing call use `screenshots:true`, inspect the returned screenshot(s), and name each captured target and size. Report Tab-key focus traversal and visible-focus counts, hash/mail links, filled/submitted forms, and observed download filenames, MIME types, and byte sizes. If the built-in tool is environmentally unavailable, keep rendered behavior unverified; do not search for or install Playwright, Puppeteer, Chromium, or another browser runtime.--Rendered evidence belongs to the exact UI revision it captured. After any change that may affect layout or behavior, discard affected pre-change evidence; after the final relevant edit, rerun `html_preview` with `screenshots:true`, inspect the new screenshots and interaction evidence, and report only that post-change evidence. If this rerun is unavailable, keep the affected behavior unverified.-## UI Rules- Prefer existing app components, tokens, icons, spacing, and interaction patterns.diff --git a/resources/builtin/marketplace/skills/fc125b9df078/_meta.json b/resources/builtin/marketplace/skills/fc125b9df078/_meta.jsonindex 58d019c5..7e24bbbb 100644--- a/resources/builtin/marketplace/skills/fc125b9df078/_meta.json+++ b/resources/builtin/marketplace/skills/fc125b9df078/_meta.json@@ -1,6 +1,6 @@{- "version": "1.0.10",- "updated_at": "2026-09-15T09:12:53.592Z",+ "version": "1.0.11",+ "updated_at": "2026-10-20T07:26:23.314Z","min_app_version": "1.6.2","reseed_if_deleted_before": "2026-07-28T13:32:31Z","category": "rnd",diff --git a/resources/builtin/marketplace/skills/fc125b9df078/references/ui-implementation.md b/resources/builtin/marketplace/skills/fc125b9df078/references/ui-implementation.mdindex 2c3d1870..93723b0c 100644--- a/resources/builtin/marketplace/skills/fc125b9df078/references/ui-implementation.md+++ b/resources/builtin/marketplace/skills/fc125b9df078/references/ui-implementation.md@@ -21,12 +21,17 @@ Capture only what is needed:4. If multiple inspectable source screens define the scope, enumerate the complete set and keep one row per source: identity/path, target route/component, must-preserve visible anchors, intentional changes, and separate `inspected`, `implemented`, and `compared` status. Do not sample the set when promising complete coverage.5. Implement in small changes.6. Check text fit at the actual requested viewport; check responsive behavior only when the user requests multi-device or narrow-screen support.-7. For a standalone artifact, include visible focus treatment, semantic labels or alt text, and `prefers-reduced-motion`; keep every requested section and action reachable, and back each action with included or inline sample content rather than a missing placeholder file.-8. For a runnable local HTML entry, call `html_preview` with the actual requested viewport target. `screenshots` defaults to false; use `screenshots:true` only for the final visual review. Use `target:"responsive"` only for an explicit responsive, multi-device, or narrow-screen request; otherwise omit target for desktop or use mobile for an explicitly mobile artifact. Source inspection, a media-query grep, a local server, PID, or HTTP response cannot prove rendered behavior.-9. If any requested viewport fails, repair the reported defect and rerun the same entry; failed checks return diagnostics without screenshots. Do not mask horizontal overflow with a global `overflow-x: hidden` or shrink the entire page.-10. Before claiming a multi-screen source set complete, compare every promised screen against a fresh rendered target. Build success, route/link validity, shared tokens, no-overflow checks, and spot checks do not prove unreviewed screens. If coverage is partial, name every remaining source; if the user contradicts fidelity, reopen the full ledger before asking for an example already present in the sources.-11. In the final handoff, name every user-requested screenshot size actually captured and inspected. Report Tab-key focus traversal and visible-focus counts, hash/mail links, filled/submitted forms, and observed download filenames, MIME types, and byte sizes.-12. When `html_preview` is unavailable or fails for an environmental reason, label browser, requested viewport behavior, link, form, and download checks unverified and provide copy-paste deployment steps for a static host. Still make the verification plan concrete: name each requested viewport, overflow/text-fit checks, tab order and focus, link targets, form behavior, and generated download content and filename. Do not search for or install another browser runtime.+7. For a standalone artifact, include visible focus treatment, adequate contrast, semantic labels or alt text, and `prefers-reduced-motion`; keep every requested section and action reachable, and back each action with included or inline sample content rather than a missing placeholder file.++## Verification and handoff++1. For a runnable local HTML entry, call `html_preview` on the actual entry. Use `target:"responsive"` only for an explicit responsive, multi-device, or narrow-screen request; otherwise omit target for desktop or use mobile for an explicitly mobile artifact. Source inspection, a media-query grep, a local server, PID, or HTTP response cannot prove rendered behavior.+2. Inspect diagnostics and repair recoverable runtime, resource, layout, focus, or interaction defects, then rerun the same entry. Failed checks return diagnostics without screenshots. Do not mask horizontal overflow with a global `overflow-x: hidden` or shrink the entire page.+3. Keep `screenshots` false for audit-only calls. After any relevant edit, discard affected earlier evidence; after the final relevant edit, run with `screenshots:true` for every requested target and inspect the fresh screenshots and interaction evidence.+4. Check each requested action's actual result against its purpose, including navigation destinations, form behavior, and generated download content and filename. A triggered event, declared MIME type, or nonzero byte count alone does not establish that the result is correct or usable. Use available tools to inspect the result; keep any check you cannot perform explicitly unverified.+5. Before claiming a multi-screen source set complete, compare every promised screen against a fresh rendered target. Build success, route/link validity, shared tokens, no-overflow checks, and spot checks do not prove unreviewed screens. If coverage is partial, name every remaining source; if the user contradicts fidelity, reopen the full ledger before asking for an example already present in the sources.+6. If `html_preview` is environmentally unavailable, keep the affected rendered and interaction behavior unverified and state the blocker. Do not search for or install another browser runtime.+7. In the final handoff, summarize the requested behavior verified on the final revision, captured targets and sizes, unresolved failures, and unverified paths. Keep diagnostic counts internal unless needed to explain a finding or requested by the user. For standalone output, include copy-paste deployment steps for a suitable static host and an executable checklist for remaining recipient checks: requested viewports, overflow/text fit, tab order and visible focus, link targets, forms, and generated download content and filename.## Design Decisions To Make Explicit@@ -49,7 +54,6 @@ Capture only what is needed:- Keyboard focus and accessible names are present where needed.- Motion respects the user's reduced-motion preference.- UI remains usable at every user-requested viewport.-- Runnable local HTML has a fresh successful `html_preview` result for every user-requested viewport, or the rendered result remains explicitly unverified with the exact blocker.- External style references are adapted, not copied wholesale.## Handoff Notediff --git a/test/main/quality/product-developer-builtin.test.ts b/test/main/quality/product-developer-builtin.test.tsindex 684a2f57..9fce956b 100644--- a/test/main/quality/product-developer-builtin.test.ts+++ b/test/main/quality/product-developer-builtin.test.ts@@ -104,14 +104,8 @@ describe('ProductDeveloper builtin contract', () => {const productUi = fs.readFileSync(path.join(builtinMarketplaceRoot, 'skills', 'fc125b9df078', 'SKILL.md'), 'utf8',);- expect(productUi).toContain('prefers-reduced-motion');- expect(productUi).toContain('copy-paste deployment steps');- expect(productUi).toContain('missing placeholder file');- expect(productUi).toContain('Add mobile or multi-device reflow only when the user requests it');- expect(productUi).toContain('screenshots:true');- expect(productUi).toContain('Tab-key focus traversal');- expect(productUi).toContain('observed download filenames');- expect(productUi).toContain('do not search for or install Playwright');+ expect(productUi).toContain('references/ui-implementation.md');+ expect(productUi).not.toContain('Tab-key focus traversal');const productDevRoot = path.join(builtinMarketplaceRoot, 'skills', '68fb048b85cb');const repositoryIntake = fs.readFileSync(path.join(productDevRoot, 'references', 'repository-intake.md'), 'utf8');@@ -315,43 +309,27 @@ describe('ProductDeveloper builtin contract', () => {);expect(productUiSkill).toContain('standalone greenfield UI');expect(productUiSkill).toContain('Do not replace implementation with a handoff plan');- expect(productUiSkill).toContain('prefers-reduced-motion');- expect(productUiSkill).toContain('copy-paste deployment steps');- expect(productUiSkill).toContain('missing placeholder file');- expect(productUiSkill).toContain('target:"responsive"` only when the user explicitly requests');- expect(productUiSkill).toContain('otherwise omit target for desktop');- expect(productUiSkill).toContain('`screenshots` defaults to false');- expect(productUiSkill).toContain('`screenshots:true` only for the final visual review');- expect(productUiSkill).toContain('call `html_preview` on the actual entry before completion');- expect(productUiSkill).toContain('desktop by default');- expect(productUiSkill).not.toContain('include every requested section and reachable action, mobile reflow');- expect(productUiSkill).not.toContain('at least one desktop and one mobile viewport');- expect(productUiSkill).toContain('Do not hide overflow globally');- expect(productUiSkill).toContain('do not search for or install Playwright');- expect(productUiSkill).toContain('observed download filenames, MIME types, and byte sizes');- expect(productUiSkill).toContain('Rendered evidence belongs to the exact UI revision it captured');- expect(productUiSkill).toContain('report only that post-change evidence');- expect(productUiSkill).toContain('one source-to-target row per screen');- expect(productUiSkill).toContain('A partial result names every remaining screen');- expect(productUiSkill).toContain('reopens the full ledger');- expect(productUiSkill).not.toMatch(/#contact|390\s*[×x]\s*844|1440\s*[×x]\s*900/i);- expect(productUiImplementation).toContain('clear standalone greenfield UI artifact');- expect(productUiImplementation).toContain('explicitly targets an existing app');+ // The implementation reference owns the procedure. The entry must route+ // standalone and in-app work to it, rather than duplicate its checks.+ expect(productUiSkill).toContain('including standalone');+ expect(productUiSkill).toContain('references/ui-implementation.md');+ expect(productUiSkill).not.toMatch(/screenshots:true|Tab-key focus traversal|observed download filenames/);expect(productUiImplementation).toContain('prefers-reduced-motion');expect(productUiImplementation).toContain('copy-paste deployment steps');expect(productUiImplementation).toContain('missing placeholder file');- expect(productUiImplementation).toContain('target:"responsive"` only for an explicit responsive, multi-device, or narrow-screen request');+ expect(productUiImplementation).toContain('target:"responsive"');expect(productUiImplementation).toContain('otherwise omit target for desktop');- expect(productUiImplementation).toContain('`screenshots` defaults to false');- expect(productUiImplementation).toContain('`screenshots:true` only for the final visual review');- expect(productUiImplementation).toContain('call `html_preview`');- expect(productUiImplementation).toContain('Requested viewport targets');+ expect(productUiImplementation).toContain('html_preview');+ expect(productUiImplementation).toContain('screenshots:true');expect(productUiImplementation).toContain('overflow-x: hidden');expect(productUiImplementation).toContain('Do not search for or install another browser runtime');- expect(productUiImplementation).toContain('observed download filenames, MIME types, and byte sizes');- expect(productUiImplementation).toContain('separate `inspected`, `implemented`, and `compared` status');+ expect(productUiImplementation).toContain('separate \u0060inspected\u0060, \u0060implemented\u0060, and \u0060compared\u0060 status');expect(productUiImplementation).toContain('compare every promised screen against a fresh rendered target');expect(productUiImplementation).toContain('reopen the full ledger');+ expect(productUiImplementation).toContain('after the final relevant edit');+ expect(productUiImplementation).toContain('actual result');+ expect(productUiImplementation).toContain('unverified');+ expect(productUiImplementation).not.toContain('Report Tab-key focus traversal and visible-focus counts');const reviewAndFinish = fs.readFileSync(path.join(productDevDir, 'references', 'review-and-finish.md'),