AGENT SKILL

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

License 许可
MIT
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
worktable-create-or-manage-interactive-html
description
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

02 资源文件 2

03 SKILL.md 正文

Build HTML

Use an HTML doc for an interactive tool, visual explanation, or custom view. Keep it understandable when opened outside the current conversation.

Use the Worktable tools the connection lists. On a Worktable that lists the earlier grouped tools, such as worktable_discover, use the listed tool with the matching request.action instead.

Choose the composition

  • Presentation or visual brief: keep the complete high-level experience in one HTML Doc. Link a narrative Doc when deeper reasoning or source notes matter independently.
  • Board, tracker, planner, directory, or dashboard: keep independently changing entities in Records; make the HTML Doc a focused view that subscribes to and updates those Records.
  • Calculator or mini tool: keep deterministic logic in the HTML. Use worktable.state only for interface-local drafts, filters, selections, or preferences. Create Records only when outputs need durable identity or reuse.
  • Live external data: request network access only when the user actually needs it. Prefer Worktable runtime APIs for Worktable data.

Build the artifact

  1. Discover the workspace and related artifacts. Update the existing HTML Doc when it already owns the job. A new HTML Doc needs a lifetime: durable for interfaces people will return to, temporary for a one-off view that only supports current work. Check a document's lifetime with worktable_files_read; change it later with worktable_files_update and lifetime.
  2. Before updating an existing HTML Doc, read its source with worktable_html_read. List open annotations with worktable_annotations_read filtered by its htmlId, inspect the context of relevant instructions, and preserve user-owned content that the request does not replace.
  3. Make the purpose and primary action clear. Use the content and task to choose the layout.
  4. Read worktable_guidance with topic: "html" and the runtime profile for the authoritative sandbox, bridge, permission, and data contract. Do not treat visual workflow guidance as a server security boundary.
  5. Model and seed canonical Records first when the interface depends on them. Then write the HTML Doc with the narrowest permissions that cover its actual calls; a new one is one complete self-contained HTML document. Change an existing HTML Doc with edits copied exactly from your read, passing its revision as expectedRevision, and replace the whole page only when most of it changes.
  6. Validate Mermaid sources with worktable_mermaid when embedding a diagram or returned SVG. Repair actionable Worktable validation warnings.
  7. Inspect desktop/mobile and light/dark screenshots with worktable_files_render (or request a preview when you write the HTML). Read the image and diagnostics, then correct the source. Previews disable persistent writes and external network; partial identifies incomplete or blocked content. If a saved write's preview fails, retry worktable_files_render, not the write. Separately exercise important controls in the real interface and verify that intended Record mutations survive rereading the collection. Exercise controls that change or delete Records only on Records you created for this work, meaning worktable_records_create returned created: true (created: false means the ID already belonged to a Record). For the user's existing Records, ask before changing a value and restore it afterwards, and never test a delete on them, because deleted Records cannot be recovered.

Verify the result

  • Comprehension: use descriptive headings and a clear next action. Remove controls, metrics, and decoration that do not help the task.
  • Visual craft: follow "Make the page easy to take in" in the HTML guide: lead with the point, show rather than tell, say each fact once, and cut what a reader would skip. Use Worktable's theme variables, and render the page to look at it before you hand off.
  • Interaction: give every control a purpose and legible loading, saving, success, empty, and failure states where relevant. Record-backed actions must update canonical Records, not only local HTML.
  • Accessibility: use semantic headings and native controls, visible focus, keyboard operation, comfortable targets, reduced-motion support, and a non-drag path for drag-and-drop workflows.
  • Continuity: explain the artifact without relying on the transcript, link supporting durable work, preserve user-owned content, and make the next update straightforward.

Return urlToSendInChat as the entry point and briefly name the durable sources behind the interface. The artifact is complete when its purpose is clear, its important path works with the intended data, and the user can return through one stable link. If you could not exercise a control or render a view, say which, rather than reporting it as verified.

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

find-movie-clips

Finds the video clip of a movie or TV scene and turns it into one clean reference take for an AI remake, a parody, an edit or a motion-control run. Covers which clip database fits a quote, a film and scene, a look or a character; which of them an agent may fetch and which only a person opens; a tested yt-dlp search and download; cutting straight from a public-domain film on the Internet Archive; a script that splits a scene into uncut takes with a contact sheet; the rules for a take a video model can follow; and a rights check. Use when someone asks where to find movie clips, film scene references, a scene by its quote, scene packs, a reference video for Seedance, Kling Motion Control, MiniMax Recast or Higgsfield Genjutsu, or says the source has cuts, watermarks or black bars. For still frames use find-references; for the remake itself use scene-recast-video.

★ 1.6k