Skip to content

armgit / Orkas

Public Imported from GitHub
0

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.

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.md
index 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 on
3. 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.json
index 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.md
index 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 Note
diff --git a/test/main/quality/product-developer-builtin.test.ts b/test/main/quality/product-developer-builtin.test.ts
index 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'),